🎯

markitdown

🎯Skill

from 0xdarkmatter/claude-mods

What it does

Converts local documents like PDFs, Word, Excel, PowerPoint, images, and audio files to clean Markdown with a single CLI command.

📦

Part of

0xdarkmatter/claude-mods(36 items)

markitdown

Installation

Add MarketplaceAdd marketplace to Claude Code

/plugin marketplace add 0xDarkMatter/claude-mods

Install PluginInstall plugin from marketplace

/plugin install claude-mods@0xDarkMatter-claude-mods

git cloneClone repository

git clone https://github.com/0xDarkMatter/claude-mods.git

📖 Extracted from docs: 0xdarkmatter/claude-mods

Need more details? View full documentation on GitHub →

8Installs

AddedFeb 4, 2026

View on GitHub Back to Skills

Skill Details

SKILL.md

"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."

Overview

# 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.

More from this repository10

🎯

python-async-patterns🎯Skill

python-async-patterns skill from 0xdarkmatter/claude-mods

🎯

container-orchestration🎯Skill

Automates deployment, scaling, and management of containerized applications across multiple hosts using advanced orchestration strategies and best practices.

🎯

file-search🎯Skill

file-search skill from 0xdarkmatter/claude-mods

🎯

claude-code-debug🎯Skill

claude-code-debug skill from 0xdarkmatter/claude-mods

🎯

tailwind-patterns🎯Skill

Provides quick, practical Tailwind CSS utility class references and responsive design patterns for rapid frontend development.

🎯

security-patterns🎯Skill

Provides comprehensive security patterns and OWASP guidelines for preventing common web application vulnerabilities across different programming languages.

🎯

find-replace🎯Skill

find-replace skill from 0xdarkmatter/claude-mods

🎯

python-pytest-patterns🎯Skill

python-pytest-patterns skill from 0xdarkmatter/claude-mods

🎯

claude-code-templates🎯Skill

claude-code-templates skill from 0xdarkmatter/claude-mods

🎯

testing-patterns🎯Skill

Explores universal testing strategies and patterns, covering test pyramid, types, naming conventions, and test doubles across programming languages.