Skip to content
Skills Library
Documents & office · Conversion & formats

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.

Licence
MIT
Last repository change
27.10.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 27.10.2026, without references to retired models or APIs.

Licence

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

convert to markdownread this documentextract text fromparse this file
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

  1. What MarkItDown Does
  2. When to Use MarkItDown
  3. When NOT to Use MarkItDown
  4. How to Use
  5. Important Notes
Original SKILL.md headings · 82 lines, 645 words
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

RepositoryScoreLicence
This page · pleaseai/claude-code-plugins100MIT
TerminalSkills/skills100Apache-2.0
matematicsolutions/awesome-matematic-skills-pl100MIT
rashadansari/myagents100MIT
julianobarbosa/claude-code-skills100MIT
jacardl/viceroy-skills98MIT
0xDarkMatter/claude-mods95MIT
jackspace/ClaudeSkillz95MIT
AlbertZJ/dsh-markitdown90MIT

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 +…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.