markitdown
/markitdown
Convert documents to Markdown using MarkItDown MCP tools. Use when the user wants to convert PDF, read PPTX, extract text from DOCX, convert document to markdown, or mentions .pdf/.docx/.pptx/.xlsx/.xls/.ppt/.doc files for reading or conversion. Triggers on phrases like "convert to markdown", "read this document", "extract text from", "parse this file" with binary document formats.
- Author
- pleaseai ↗
- Repository
- claude-code-plugins ↗
- Licence
- MIT
- Last repository change
- 27.10.2026
Assessment and security
- Files in this package
- 1
- Scripts
- 0
- HTML comments
- 0
- URLs in SKILL.md
- 0
No signals detected. Repository changed on 27.10.2026, without references to retired models or APIs.
MIT, open: use and modify while retaining author attribution.
What it does and when to use it
Convert documents to Markdown using MarkItDown MCP tools. Use when the user wants to convert PDF, read PPTX, extract text from DOCX, convert document to markdown, or mentions .pdf/.docx/.pptx/.xlsx/.xls/.ppt/.doc files for reading or conversion. Triggers on phrases like "convert to markdown", "read this document", "extract text from", "parse this file" with binary document formats.
Triggers from the description
Original author description
Convert documents to Markdown using MarkItDown MCP tools. Use when the user wants to convert PDF, read PPTX, extract text from DOCX, convert document to markdown, or mentions .pdf/.docx/.pptx/.xlsx/.xls/.ppt/.doc files for reading or conversion. Triggers on phrases like "convert to markdown", "read this document", "extract text from", "parse this file" with binary document formats.
How it works
- What MarkItDown Does
- When to Use MarkItDown
- When NOT to Use MarkItDown
- How to Use
- Important Notes
SKILL.md preview
--- name: markitdown description: Convert documents to Markdown using MarkItDown MCP tools. Use when the user wants to convert PDF, read PPTX, extract text from DOCX, convert document to markdown, or mentions .pdf/.docx/.pptx/.xlsx/.xls/.ppt/.doc files for reading or conversion. Triggers on phrases like "convert to markdown", "read this document", "extract text from", "parse this file" with binary document formats. allowed-tools: mcp__markitdown__* --- # MarkItDown - Document to Markdown Conversion Use `mcp__markitdown__convert_to_markdown` whenever the user needs to read or extract text from binary document formats that Claude's native Read tool cannot parse. ## What MarkItDown Does MarkItDown converts binary and structured document formats into clean, readable Markdown text. It preserves document structure including headings, tables, lists, and other formatting elements. **Supported formats:** - **Office documents**: DOCX, PPTX, XLSX, DOC, PPT, XLS - **PDF**: PDF files (though Claude's Read tool also handles PDFs natively) - **Images**: PNG, JPG, JPEG, GIF, BMP, TIFF (extracts text via OCR when available) - **Web formats**: HTML, HTM - **Data formats**: CSV, JSON, XML - **Archives**: ZIP (extracts and converts contents) - **Audio**: MP3, WAV (transcribes audio when possible) - **eBooks**: EPUB ## When to Use MarkItDown Use the markitdown MCP tool when: 1. **The file is a binary Office format**: `.docx`, `.pptx`, `.xlsx`, `.doc`, `.ppt`, `.xls` — Claude's Read tool returns garbled binary data for these formats. MarkItDown is the only reliable way to extract their text content. 2. **The user wants structured extraction**: When the user needs to preserve table structure, slide content, spreadsheet data, or document formatting in a machine-readable form. 3. **Processing multiple documents in a ZIP**: When a ZIP archive contains documents that need to be converted together. 4. **The user explicitly asks to "convert to markdown"**: Regardless of file type, honor this intent by using MarkItDown. ## When NOT to Use MarkItDown Do NOT use MarkItDown for: - **Plain text files** (`.txt`, `.md`, `.csv`, `.json`, `.xml`, `.html`): Use Claude's native Read tool — it handles these perfectly and is faster. - **Source code files** (`.py`, `.js`, `.ts`, `.java`, etc.): Use the Read tool directly. - **PDF files**: For PDF extraction, prefer **EdgeParse** (`edgeparse` plugin) — it is faster, preserves document structure (headings, tables, bounding boxes), and supports page ranges and borderless tables. Only fall back to MarkItDown for PDFs when EdgeParse is not installed. - **Images when the user wants visual analysis**: Use Claude's native image understanding instead of OCR-only text extraction. ## How to Use ### Basic document conversion Call `mcp__markitdown__convert_to_markdown` with a `file://` URI: ``` mcp__markitdown__convert_to_markdown(uri="file:///absolute/path/to/document.docx") ``` The tool accepts `http:`, `https:`, `file:`, or `data:` URIs. For local files, always use the `file://` scheme with an absolute path (`file:///path/to/file`). The tool returns the document content as a Markdown string. Use this output directly to answer the user's question or to further process the content. ### Workflow for binary documents When the user asks to read, summarize, or analyze a `.docx`, `.pptx`, or `.xlsx` file: 1. Construct a `file://` URI from the absolute path (e.g. `file:///home/user/report.docx`) 2. Call `mcp__markitdown__convert_to_markdown` with the `uri` argument 3. Read the returned Markdown content 4. Answer the user's question based on the extracted content Do not attempt to use the Read tool on these binary formats first — it will return unreadable binary data and waste time. ### Handling PPTX (PowerPoint) files PowerPoint files convert to Markdown with each slide's content. Slide titles become headings, bullet points become list items, and tables are preserved. Speaker notes may also be included. ### Handling XLSX (Excel) files Excel spreadsheets convert with each sheet's data rendered as Markdown tables. Multiple sheets are separated with sheet name headings. ### Handling DOCX (Word) files Word documents convert with full structure: headings, paragraphs, tables, and lists are all preserved in Markdown format. ## Important Notes - **Always use `file://` URIs with absolute paths**: Construct the URI as `file:///absolute/path/to/file`. Relative paths are not supported — resolve to absolute first if needed. - **The MCP server uses `uvx markitdown-mcp`**: It requires `uv` to be installed on the system. If the tool fails, check that `uv` is available. - **Large files**: Very large documents (hundreds of pages) may take longer to convert. This is expected behavior. - **Password-protected files**: MarkItDown cannot open password-protected Office documents or encrypted PDFs without the password.
Versions
| Repository | Score | Licence |
|---|---|---|
| This page · pleaseai/claude-code-plugins | 100 | MIT |
| TerminalSkills/skills | 100 | Apache-2.0 |
| matematicsolutions/awesome-matematic-skills-pl | 100 | MIT |
| rashadansari/myagents | 100 | MIT |
| julianobarbosa/claude-code-skills | 100 | MIT |
| jacardl/viceroy-skills | 98 | MIT |
| 0xDarkMatter/claude-mods | 95 | MIT |
| jackspace/ClaudeSkillz | 95 | MIT |
| AlbertZJ/dsh-markitdown | 90 | MIT |
Database snapshot: 13.11.2026 · package version 3c76dd6c0ec0 (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 100alterlab-markitdown
Converts files and Office documents to clean, LLM-friendly Markdown with Microsoft MarkItDown (markitdown CLI, Python API, and markitdown-mcp server), supporting PDF, DOCX, PPTX, XLSX/XLS, images (EXIF metadata, LLM descriptions), audio (transcription), HTML, CSV, JSON, XML, ZIP… - 95Documents
Read, write, convert, and analyze documents — routes to PDF, DOCX, XLSX, PPTX sub-skills for creation, editing, extraction, and format conversion. USE WHEN document, process file, create document, convert format, extract text, PDF, DOCX, XLSX, PPTX, Word, Excel, spreadsheet,… - 100document-conversion
Converts documents and URLs to markdown via tiered fallback (MCP markitdown, native tools, user notice). Use when a skill must ingest PDF, DOCX, or URL content. - 100skill-doc-delivery
Convert markdown to DOCX, PPTX, XLSX, PDF office documents — use when you need exportable deliverables - 100to-markdown
Convert any file or URL to clean Markdown: PDF, DOCX, XLSX, PPTX, HTML, images (OCR), audio, CSV, YouTube. Optimised for LLM pipelines. Triggers on: "convert to markdown", "extract text from PDF", "parse this document", "ingest for RAG". - 100wise-markitdown
File-to-markdown text extraction via Microsoft's `markitdown` CLI — the ONE tool to reach for whenever text/content must be extracted from a binary or structured file: PDF, Word (.docx), PowerPoint (.pptx), Excel (.xlsx/.xls), images (EXIF metadata), audio (metadata +…