
Markitdown
Microsoft's MarkItDown converts PDFs, Office docs, images, audio, and web content into markdown for feeding to LLMs. The Python utility handles 15+ formats with optional extras for specific file types. It works via CLI or API, supports batch processing, and can call GPT-4 to describe images instead of just OCR. The gotchas are real: DOCX images extract to absolute paths that break when you move files, HTML tables lose CSS layout and become linear mush, and the LLM flag silently degrades to filenames if your API key is missing. Best for preprocessing document pipelines where you control the input formats and can validate output quality before it hits your model.
- skills.sh installs
- 1.7K
- GitHub stars
- 15
- last updated
- Aug 21, 2026
Install
$ npx -y skills add julianobarbosa/claude-code-skills --skill markitdown --agent claude-codeInstalls into .claude/skills of the current project.
Files
MarkItDown Skill
Microsoft's Python utility for converting various file formats to Markdown for LLM and text analysis pipelines.
Overview
MarkItDown converts documents while preserving structure (headings, lists, tables, links). It's optimized for LLM consumption rather than human-readable output.
Supported Formats
| Category | Formats |
|---|---|
| Documents | PDF, Word (DOCX), PowerPoint (PPTX), Excel (XLSX, XLS) |
| Media | Images (EXIF + OCR), Audio (WAV, MP3 transcription) |
| Web | HTML, YouTube URLs, Wikipedia, RSS/Atom feeds |
| Data | CSV, JSON, XML, Jupyter notebooks (.ipynb) |
| Archives | ZIP (iterates contents), EPub |
| Outlook MSG files |
Quick Start
Installation
# Full installation (recommended)
pip install 'markitdown[all]'
# Minimal with specific formats
pip install 'markitdown[pdf,docx,pptx]'
# Using uv
uv pip install 'markitdown[all]'
Optional Dependencies
Sponsors
Details
- Repository
- github.com/julianobarbosa/claude-code-skills
- Categories
- Frontend Development, Documentation, Code Review & Quality, AI & Agent Building, Data Science & ML, Python, Office & Documents
- First seen
- Jul 14, 2026