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

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.

Repository
claude-mods ↗
Licence
MIT
Last repository change
15.10.2026

Assessment and security

95/ 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.
Content30 / 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
4
Scripts
0
HTML comments
0
URLs in SKILL.md
2
Deprecation

No signals detected. Repository changed on 15.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 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

  1. When to Use markitdown
  2. Basic Usage
  3. Supported Formats
  4. Benchmarked Performance (URLs)
  5. Examples
  6. Comparison with Alternatives
Original SKILL.md headings · 87 lines, 378 words
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

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

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

Feedback and reports

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