markitdown

Convert diverse file formats into LLM-optimized Markdown.

4|Updated Jan 30, 2026
One-click install
npx skills add https://github.com/Xueheng-Li/ai-tools-installation --skill markitdown-xueheng-li
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: markitdown
Source: https://github.com/Xueheng-Li/ai-tools-installation/tree/main/recommended_skills/markitdown
Command: npx skills add https://github.com/Xueheng-Li/ai-tools-installation --skill markitdown-xueheng-li

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires markitdown, openai, and includes scripts (resource) and references (resource) components.

What problem does it solve?

Users spend excessive time manually copying, re‑formatting, and cleaning content from PDFs, Office documents, images, audio, web pages, and structured data before they can be used with large language models. This Skill automates that conversion, delivering clean, token‑efficient Markdown ready for downstream AI workflows.

Core Features & Use Cases

  • 20+ format support: PDF, DOCX, PPTX, XLSX, images, audio, HTML, EPUB, CSV, JSON, XML, ZIP, and more.
  • Batch processing: Convert entire directories with a single command.
  • Azure Document Intelligence: Enhanced extraction for complex PDFs with tables and forms.
  • LLM‑powered image descriptions: Generate detailed alt‑text using GPT‑4o or similar models.
  • Audio transcription: Turn speech recordings into searchable text.
  • Web content extraction: Pull clean Markdown from web pages, YouTube transcripts, and RSS feeds.
  • Plugin system: Extend conversion logic with custom plugins (disabled by default for safety).

Quick Start

Ask the markitdown skill to convert the folder ‘research_papers’ into Markdown files.

Frequently Asked Questions about markitdown

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert PDF and Office documents to Markdown for LLM workflows?

To convert documents to Markdown for LLM workflows, you can use this tool to process PDFs, DOCX, PPTX, and XLSX files, delivering clean, token-efficient text. It supports batch processing for entire directories.

Does converting images to Markdown require OpenAI credentials?

Converting images to Markdown with AI-powered descriptions does require OpenAI credentials. However, standard image OCR extraction works without them, utilizing the underlying MarkItDown library's default capabilities.

Can I batch convert multiple file formats like HTML, CSV, and JSON into Markdown?

You can batch convert multiple file formats including HTML, CSV, JSON, and XML into Markdown by specifying a directory. This processes the entire folder structure with a single command.

What is the best way to extract text from audio recordings for large language models?

The best way to extract text from audio recordings for large language models is using this tool's audio transcription feature. It turns speech recordings into searchable, LLM-ready Markdown text.

Do I need Azure Document Intelligence to parse complex PDF tables into Markdown?

You need Azure Document Intelligence specifically for enhanced extraction of complex PDFs containing tables and forms. Standard PDF conversion works without it, but Azure provides superior structured data parsing.

How do I extract clean text from web pages and YouTube transcripts into Markdown?

To extract clean text from web pages and YouTube transcripts into Markdown, this tool pulls content directly from URLs and RSS feeds. It outputs structured, LLM-optimized Markdown without manual formatting.