markitdown
/markitdown
Convert local documents to Markdown using Microsoft's markitdown CLI. Best for: PDF, Word, Excel, PowerPoint, images (OCR), audio. Can fetch URLs but Jina is faster for web. Triggers on: convert to markdown, read PDF, parse document, extract text from, docx, xlsx, pptx, OCR image, local file.
- Author
- 0xDarkMatter ↗
- Repository
- claude-mods ↗
- Licence
- MIT
- Last repository change
- 15.10.2026
Assessment and security
- Files in this package
- 4
- Scripts
- 0
- HTML comments
- 0
- URLs in SKILL.md
- 2
No signals detected. Repository changed on 15.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 local documents to Markdown using Microsoft's markitdown CLI. Best for: PDF, Word, Excel, PowerPoint, images (OCR), audio. Can fetch URLs but Jina is faster for web. Triggers on: convert to markdown, read PDF, parse document, extract text from, docx, xlsx, pptx, OCR image, local file.
Original author description
Convert local documents to Markdown using Microsoft's markitdown CLI. Best for: PDF, Word, Excel, PowerPoint, images (OCR), audio. Can fetch URLs but Jina is faster for web. Triggers on: convert to markdown, read PDF, parse document, extract text from, docx, xlsx, pptx, OCR image, local file.
How it works
- When to Use markitdown
- Basic Usage
- Supported Formats
- Benchmarked Performance (URLs)
- Examples
- Comparison with Alternatives
SKILL.md preview
--- name: markitdown description: "Convert local documents to Markdown using Microsoft's markitdown CLI. Best for: PDF, Word, Excel, PowerPoint, images (OCR), audio. Can fetch URLs but Jina is faster for web. Triggers on: convert to markdown, read PDF, parse document, extract text from, docx, xlsx, pptx, OCR image, local file." license: MIT compatibility: "Requires markitdown. Install: pip install markitdown" allowed-tools: "Bash" metadata: author: claude-mods --- # markitdown - Document to Markdown Convert local documents to clean Markdown. One tool for PDF, Word, Excel, PowerPoint, images, and more. ## When to Use markitdown | Use Case | Recommendation | |----------|----------------| | **Local files (PDF, Word, Excel)** | ✅ **Use markitdown** - unique capability | | **Web pages** | ❌ Use Jina (`r.jina.ai/`) - 5x faster | | **Blocked/anti-bot sites** | ❌ Use Firecrawl | | **OCR on images** | ✅ **Use markitdown** | | **Audio transcription** | ✅ **Use markitdown** | ## Basic Usage ```bash # Local files (primary use case) markitdown document.pdf markitdown report.docx markitdown data.xlsx markitdown slides.pptx markitdown screenshot.png # OCR # URLs (works, but Jina is faster) markitdown https://example.com # Save output markitdown document.pdf > document.md ``` ## Supported Formats | Format | Extensions | Notes | |--------|------------|-------| | PDF | `.pdf` | Text extraction, tables | | Word | `.docx` | Formatting preserved | | Excel | `.xlsx` | Tables to markdown | | PowerPoint | `.pptx` | Slides as sections | | Images | `.jpg`, `.png` | OCR text extraction | | HTML | `.html` | Clean conversion | | Audio | `.mp3`, `.wav` | Speech-to-text | | Text | `.txt`, `.csv`, `.json`, `.xml` | Pass-through/structure | | URLs | `https://...` | Works but slower than Jina | ## Benchmarked Performance (URLs) | Tool | Avg Speed | Success Rate | |------|-----------|--------------| | Jina | **0.5s** | 10/10 | | markitdown | 2.5s | 9/10 | | Firecrawl | 4.5s | 10/10 | **Verdict**: For URLs, use Jina. For local files, markitdown is the only option. ## Examples ```bash # PDF to markdown (primary use case) markitdown report.pdf > report.md # Excel spreadsheet markitdown financials.xlsx # Image with text (OCR) markitdown screenshot.png # PowerPoint deck markitdown presentation.pptx > slides.md # Audio transcription markitdown meeting.mp3 > transcript.md ``` ## Comparison with Alternatives | Task | markitdown | Alternative | |------|------------|-------------| | PDF text | `markitdown file.pdf` | PyMuPDF, pdfplumber | | Word docs | `markitdown file.docx` | python-docx | | Excel | `markitdown file.xlsx` | pandas, openpyxl | | OCR | `markitdown image.png` | Tesseract | | Web pages | Use Jina instead | `r.jina.ai/URL` (5x faster) | **markitdown's advantage**: One CLI for all local document formats. No code needed.
Files in this package (4)
- SKILL.md 3 KB
- assets/.gitkeep 1 KB
- references/.gitkeep 1 KB
- scripts/.gitkeep 1 KB
Versions
| Repository | Score | Licence |
|---|---|---|
| This page · 0xDarkMatter/claude-mods | 95 | MIT |
| TerminalSkills/skills | 100 | Apache-2.0 |
| pleaseai/claude-code-plugins | 100 | MIT |
| matematicsolutions/awesome-matematic-skills-pl | 100 | MIT |
| rashadansari/myagents | 100 | MIT |
| julianobarbosa/claude-code-skills | 100 | MIT |
| jacardl/viceroy-skills | 98 | MIT |
| jackspace/ClaudeSkillz | 95 | MIT |
| AlbertZJ/dsh-markitdown | 90 | MIT |
Identical content appears in 1 other GitHub folders. We show one copy with the highest score.
Database snapshot: 13.11.2026 · package version aadca902fde3 (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
- 100markitdown-skill
Convert documents to Markdown using Microsoft's MarkItDown CLI (`markitdown`). Supports PDF, Word, PowerPoint, Excel, images (OCR), audio (transcription), HTML, YouTube, and URLs. Use when a user wants to convert a file or URL to Markdown, extract text from PDFs/images,… - 100markdown-converter
Convert documents and files to Markdown using markitdown. Use when converting PDF, Word (.docx), PowerPoint (.pptx), Excel (.xlsx, .xls), HTML, CSV, JSON, XML, images (with EXIF/OCR), audio (with transcription), ZIP archives, YouTube URLs, or EPubs to Markdown format for LLM… - 100markitdown-skill
把 PDF、Word(DOCX)、PowerPoint(PPTX)、Excel(XLSX/XLS)、图片(OCR)、音频(转写)、HTML、CSV、JSON、XML、ZIP、YouTube 链接、EPUB 等 15 种以上文件格式批量转成结构化 Markdown,保留标题层级、表格、列表与超链接,输出天然适配大模型文本分析管道。提供 markitdown 命令行、Python API 与本技能附带的零依赖调度脚本三种调用方式,支持插件扩展与 OCR、语音转写集成。当用户需要转成 Markdown、文档转换、Word 转 Markdown、PDF 转… - 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… - 100markitdown-convert
Convert any file to Markdown using Microsoft MarkItDown. Use this skill whenever the user needs to extract text from PDFs, Word documents, Excel spreadsheets, PowerPoints, EPUBs, images, audio, HTML pages, CSV, JSON, XML, ZIP archives, Jupyter notebooks, Outlook .msg files, or… - 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 +…