markitdown

Convert PDF, DOCX, PPTX, XLSX, and other documents to Markdown.

1|Updated Jan 26, 2026
One-click install
npx skills add https://github.com/Victory-Hugo/S2-Agent-Skill --skill markitdown-victory-hugo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: markitdown
Source: https://github.com/Victory-Hugo/S2-Agent-Skill/tree/main/skills/writing/markitdown
Command: npx skills add https://github.com/Victory-Hugo/S2-Agent-Skill --skill markitdown-victory-hugo

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

MarkItDown automates converting diverse documents into Markdown, providing a token-efficient format that is easier for language models to process, index, and extract data.

Core Features & Use Cases

  • Automated conversion of PDFs, DOCX, PPTX, XLSX, images (with OCR), HTML, CSV, JSON, XML, ZIP, and YouTube links into clean Markdown.
  • AI-enhanced outputs via optional OpenRouter/OpenAI integration for rich image descriptions and data summaries.
  • Batch processing with provided scripts (batch_convert.py, convert_literature.py) to scale workflows across large collections.
  • Suitable for research, documentation, and knowledge-management workflows, enabling easy ingestion into knowledge bases and citation tools.

Quick Start

Instantiate MarkItDown and run a simple conversion: from markitdown import MarkItDown md = MarkItDown() result = md.convert('document.pdf') print(result.text_content)

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 DOCX files to Markdown for LLM processing?

To convert PDF and DOCX files to Markdown for LLM processing, you can instantiate the converter and pass your file path to the conversion method. This extracts text content into a token-efficient Markdown format, making it easier for language models to index and extract data from diverse documents.

Can I batch convert multiple documents into Markdown at once?

Yes, you can batch convert multiple documents into Markdown using provided scripts like batch_convert.py and convert_literature.py. These scripts allow you to scale workflows across large collections of files, automating the extraction process for research and knowledge-management purposes.

Does converting documents to Markdown support OCR for images and audio transcripts?

Converting documents to Markdown supports OCR for images and audio transcripts alongside formats like HTML, CSV, and JSON. This enables diverse workflows by transforming visual and audio content into clean, AI-friendly Markdown text suitable for ingestion into knowledge bases.

Do I need an OpenAI API key to get AI-enhanced Markdown conversion outputs?

You do not strictly need an OpenAI API key for basic Markdown conversion, but it is required for AI-enhanced outputs. Optional OpenRouter or OpenAI integration provides rich image descriptions and data summaries, adding deeper context to your converted Markdown text.

What is the best way to handle complex document layouts when converting files to Markdown?

The best way to handle complex document layouts when converting files to Markdown is using optional Azure Document Intelligence support. This integration complements the core conversion process by accurately parsing intricate structures, ensuring cleaner Markdown output for challenging PDF and document formats.

Can I extract text from YouTube links and convert it to Markdown?

Yes, you can extract text from YouTube links and convert it to Markdown. The conversion tool supports YouTube URLs directly, transforming video transcripts into a token-efficient Markdown format that is easy for language models to process and index.