# markitdown

markitdown — a Claude Code skill that turns PDFs, Office documents, images, audio, and web pages into Markdown ready for language models. Handles 20+ formats while keeping headings, lists, tables, and links intact.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 1 install · ★ 607 repo stars
- Author: jimmc414
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/jimmc414/Kosmos/tree/HEAD/kosmos-claude-scientific-skills/scientific-skills/markitdown/SKILL.md
- Updated: 2026-10-09
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/jimmc414-markitdown

## What it does

Built on the Python utility MarkItDown: feed it a file or URL, get back clean Markdown with no temporary files left behind.

Converts PDF, DOCX, PPTX, XLSX, HTML, EPUB, CSV, JSON, and XML. Images go through OCR with EXIF metadata pulled out; audio gets transcribed via the `speech_recognition` package. A YouTube link yields its transcript. ZIP archives are unpacked whole — every file inside is converted and concatenated into one result.

For tricky PDFs there's Azure Document Intelligence integration, which extracts tables and layout more accurately. You can also wire in GPT-4o to describe images inside presentations. The extension plugin system ships disabled by default for security and turns on with `enable_plugins=True`.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add jimmc414/Kosmos --skill markitdown -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/markitdown/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/markitdown/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add jimmc414/Kosmos --skill markitdown -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/markitdown/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add jimmc414/Kosmos --skill markitdown -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/markitdown/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install jimmc414/Kosmos kosmos-claude-scientific-skills/scientific-skills/markitdown
```

2. **Manually: put the files in place**
- File: `.github/skills/markitdown/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add jimmc414/Kosmos --skill markitdown -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/jimmc414/Kosmos --path kosmos-claude-scientific-skills/scientific-skills/markitdown
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/markitdown/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add jimmc414/Kosmos --skill markitdown -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/jimmc414/Kosmos/tree/HEAD/kosmos-claude-scientific-skills/scientific-skills/markitdown/SKILL.md

## When to use it
- extract text from PDF or Office files
- run OCR on images along with EXIF data
- transcribe audio to text
- pull YouTube transcripts from a URL
- batch-convert documents for RAG or embedding pipelines

## Example prompts
- Convert `manual.pdf` to Markdown and save it as `manual.md`
- Process every file in `documents/` and write Markdown versions to `markdown/`
- Unpack `archive.zip` and convert all PDFs inside to Markdown

## Similar
- [pdf-to-markdown](https://affpapa.org/en/nevibecode/skills/pdf-to-markdown.md) — skill · 870 installs
- [markitdown-skill](https://affpapa.org/en/nevibecode/skills/markitdown-skill.md) — skill · ★ 108 repo stars
- [convert-pdf-to-md](https://affpapa.org/en/nevibecode/skills/convert-pdf-to-md.md) — skill · 138 installs
- [mineru](https://affpapa.org/en/nevibecode/skills/nebutra-mineru.md) — skill · 19 installs
- [PDF.co](https://affpapa.org/en/nevibecode/mcp/pdfco.md) — MCP server · ★ 9 repo stars
- [doc-to-markdown](https://affpapa.org/en/nevibecode/skills/doc-to-markdown.md) — skill · 945 installs

## Other versions with the same name
- [markitdown · k-dense-ai](https://affpapa.org/en/nevibecode/skills/markitdown.md) — 2400 installs
- [markitdown · julianobarbosa](https://affpapa.org/en/nevibecode/skills/julianobarbosa-markitdown.md) — 1700 installs

From the same set: [jimmc414/kosmos](https://affpapa.org/en/nevibecode/by/jimmc414/kosmos.md) — 2 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
