markitdown

Convert PDFs, DOCX, PPTX, and other formats to Markdown.

Updated Apr 26, 2026
One-click install
npx skills add https://github.com/GongXLiang/plot-study --skill markitdown-gongxliang
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: markitdown
Source: https://github.com/GongXLiang/plot-study/tree/main/.claude/plugins/cache/claude-scientific-writer/claude-scientific-writer/2f80d2aed0e6/.claude/skills/markitdown
Command: npx skills add https://github.com/GongXLiang/plot-study --skill markitdown-gongxliang

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

MarkItDown simplifies converting diverse file formats into clean, token-efficient Markdown, reducing manual reformatting and data loss during data extraction and content reuse.

Core Features & Use Cases

  • Format coverage: PDF, DOCX, PPTX, XLSX, EPUB, HTML, CSV, JSON, XML, ZIP, YouTube transcripts, images (with OCR), and audio (transcription).
  • AI-enhanced descriptions: Optional automated image descriptions via OpenRouter/OpenAI integration.
  • Batch processing: Parallel conversion scripts for large collections; easy metadata generation and cataloging.
  • Azure Document Intelligence support: Enhanced handling for complex PDFs and tables (optional).
  • Use case example: Researchers convert literature bundles to Markdown for quick analysis and note-taking.

Quick Start

Convert a sample file, e.g., sample.pdf, to Markdown using MarkItDown.

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?

Batch conversion processes large collections of files into Markdown simultaneously using parallel scripts. This enables efficient metadata generation and cataloging for researchers analyzing extensive literature bundles.

Can I generate AI image descriptions during file to Markdown conversion?

Converting files to Markdown requires Python 3.10 or higher, along with optional dependencies installed per format to enable specific AI features. A pluggable architecture allows extensibility for diverse document and media formats.

What is the best way to extract tables from complex PDFs into Markdown?

The best way to extract tables from complex PDFs is using Azure Document Intelligence support. This optional integration provides enhanced handling for intricate PDF structures and tables during the Markdown conversion process.

How do I transcribe audio and YouTube transcripts to Markdown?

Audio transcription and YouTube transcripts can be converted directly to Markdown by applying the core conversion task to media formats. This transforms spoken content and video captions into editable text for reuse.

What are the limitations of converting files to Markdown for data extraction?

Limitations include potential data loss when converting complex formatting and the requirement to install specific optional dependencies per format. Without these dependencies, certain AI-assisted features and format handling will not function.