markitdown

Convert PDF, DOCX, PPTX, XLSX, and other files into Markdown.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/enantiomer-h/DotfilePub --skill markitdown-enantiomer-h
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: markitdown
Source: https://github.com/enantiomer-h/DotfilePub/tree/main/claude-code/.claude/skills/markitdown
Command: npx skills add https://github.com/enantiomer-h/DotfilePub --skill markitdown-enantiomer-h

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

MarkItDown converts files and office documents into Markdown, delivering token-efficient, human-readable text suitable for LLM workflows. It supports a wide range of formats including PDF, DOCX, PPTX, XLSX, images (with OCR), audio (with transcription), HTML, CSV, JSON, XML, ZIP, YouTube transcripts, and EPUBs, enabling easier ingestion for research, analysis, and documentation.

Core Features & Use Cases

  • AI-enhanced image descriptions with OpenRouter/OpenAI
  • Azure Document Intelligence integration for dense PDFs
  • Batch processing, plugin system, and literature/workflow support

Quick Start

Install MarkItDown and run a sample conversion to verify Markdown output.

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 into Markdown for LLM workflows?

You can convert PDF and DOCX files into Markdown using tools that transform office documents into token-efficient, human-readable text. This process supports scientific writing, data extraction, and literature reviews by delivering clean Markdown output suitable for LLM workflows.

Can I batch process multiple files into Markdown format?

Yes, you can batch process multiple files into Markdown format. This functionality supports batch pipelines where AI-enhanced descriptions or Azure Document Intelligence improve accuracy, making it easier to ingest large volumes of research and documentation.

Do I need an OpenAI API key to convert images and audio to Markdown?

Yes, you need API keys for OpenRouter or OpenAI to convert images and audio to Markdown. These API keys enable AI-driven conversions, providing AI-enhanced image descriptions and audio transcription for your LLM workflows.

What is the best way to extract text from dense PDFs for literature reviews?

The best way to extract text from dense PDFs for literature reviews is using Azure Document Intelligence integration. This feature improves conversion accuracy for complex scientific documents, delivering token-efficient Markdown suitable for analysis.

Does this Markdown conversion approach support EPUB and YouTube transcripts?

Yes, this Markdown conversion approach supports EPUB and YouTube transcripts. It handles a wide range of formats including HTML, CSV, JSON, XML, and ZIP files, enabling easier ingestion for research and analysis.

What Python version is required to run AI-enhanced Markdown conversions?

Python 3.10 or higher is required to run AI-enhanced Markdown conversions. You also need optional extras for AI features and API keys for OpenRouter or OpenAI to enable AI-driven conversion capabilities.