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-code

Installs 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

CategoryFormats
DocumentsPDF, Word (DOCX), PowerPoint (PPTX), Excel (XLSX, XLS)
MediaImages (EXIF + OCR), Audio (WAV, MP3 transcription)
WebHTML, YouTube URLs, Wikipedia, RSS/Atom feeds
DataCSV, JSON, XML, Jupyter notebooks (.ipynb)
ArchivesZIP (iterates contents), EPub
EmailOutlook 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

More from julianobarbosa/claude-code-skills

All 8
1adobe avatarbuilding-blocksadobe/skillsUse this when implementing code changes in AEM Edge Delivery Services (EDS, Franklin, Helix), whether new or modified blocks, core functionality (scripts.js, st1.7Kskills.sh installs
2cap-go avatarionic-designcap-go/capgo-skillsGuide to using Ionic Framework components for beautiful native-looking Capacitor apps. Covers component usage, theming, platform-specific styling, and best prac1.6Kskills.sh installs
3adobe avataranalyze-and-planadobe/skillsUse this when you need to define acceptance criteria, write requirements, scope work, or create a definition of done for AEM Edge Delivery Services (EDS) tasks 1.6Kskills.sh installs
4mindrally avatartailwindcssmindrally/skillsExpert in TailwindCSS utility-first styling with responsive design patterns1.6Kskills.sh installs
5davila7 avatarremotiondavila7/claude-code-templatesBest practices and comprehensive guide for Remotion - programmatic video creation in React with animations, compositions, and media handling1.5Kskills.sh installs
6kostja94 avatarcarouselkostja94/marketing-skillsWhen the user wants to design, optimize, or audit carousel/slider layouts for content display. Also use when the user mentions "carousel," "slider," "carousel l1.4Kskills.sh installs