# markitdown

Скилл-инструкция по Microsoft MarkItDown: превращает PDF, Word, Excel, картинки и ссылки в Markdown, готовый для контекста LLM.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 1600 установок · ★ 14
- Автор: julianobarbosa
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/julianobarbosa/claude-code-skills/tree/HEAD/skills/markitdown/SKILL.md
- Обновлён: 2026-10-14
- HTML: https://affpapa.org/nevibecode/skills/julianobarbosa-markitdown

## Что делает

Скилл объясняет агенту, как работать с MarkItDown — питоновской утилитой Microsoft для перевода файлов в Markdown. Внутри разобраны поддерживаемые форматы: PDF, DOCX, PPTX, XLSX и XLS, изображения с EXIF и OCR, аудио WAV и MP3, HTML, ссылки YouTube, страницы Wikipedia, RSS-ленты, CSV, JSON, XML, блокноты Jupyter, ZIP-архивы, EPub и письма Outlook MSG. Структура документа при конвертации сохраняется: заголовки, списки, таблицы, ссылки.

Установка идёт через `pip install 'markitdown[all]'` или отдельными наборами зависимостей вроде `[pdf,docx,pptx]`. Дальше два пути: командная строка (`markitdown document.pdf -o output.md`) или Python API с классом `MarkItDown` и методом `convert`. В скилле есть готовые рецепты — пакетная обработка каталога, подготовка контекста для LLM, вытаскивание транскрипта YouTube, OCR картинок с описанием через LLM, разбор ноутбуков и RSS.

Нужен Python 3.10 или новее, автор советует виртуальное окружение. Для OCR и транскрипции аудио ставятся отдельные наборы зависимостей, а для сложных PDF есть режим Azure Document Intelligence — под него нужны endpoint и ключ в переменных окружения. Если конвертация падает с `ModuleNotFoundError`, значит не установлен набор под конкретный формат. Отдельно описаны плагины (`markitdown --list-plugins`) и MCP-сервер `markitdown-mcp`.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add julianobarbosa/claude-code-skills --skill markitdown -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/markitdown/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/markitdown/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add julianobarbosa/claude-code-skills --skill markitdown -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/markitdown/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add julianobarbosa/claude-code-skills --skill markitdown -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/markitdown/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install julianobarbosa/claude-code-skills markitdown
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/markitdown/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add julianobarbosa/claude-code-skills --skill markitdown -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/julianobarbosa/claude-code-skills --path skills/markitdown
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/markitdown/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add julianobarbosa/claude-code-skills --skill markitdown -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/julianobarbosa/claude-code-skills/tree/HEAD/skills/markitdown/SKILL.md

## Когда брать
- собрать Markdown из пачки PDF и DOCX для контекста модели
- вытащить текст из сканов и картинок через OCR
- получить транскрипт видео с YouTube одной командой
- разобрать таблицу Excel или ноутбук Jupyter в читаемый текст
- подготовить документы к загрузке в LLM-пайплайн

## Примеры запросов агенту
- Сконвертируй report.pdf в Markdown и сохрани рядом с исходником
- Прогони все файлы из папки documents через markitdown и сложи результат в markdown
- Достань транскрипт из этой ссылки на YouTube и покажи первые абзацы

## Похожие
- [convert-pdf-to-md](https://affpapa.org/nevibecode/skills/convert-pdf-to-md.md) — скилл · 138 установок
- [doc-to-markdown](https://affpapa.org/nevibecode/skills/doc-to-markdown.md) — скилл · 872 установки
- [pandoc](https://affpapa.org/nevibecode/skills/pandoc.md) — скилл · 484 установки
- [paddleocr-doc-parsing](https://affpapa.org/nevibecode/skills/paddleocr-doc-parsing.md) — скилл · 471 установка
- [markdown-converter](https://affpapa.org/nevibecode/skills/steipete-markdown-converter.md) — скилл · 339 установок
- [MinerU Open MCP](https://affpapa.org/nevibecode/mcp/mineru-open-mcp.md) — MCP-сервер · ★ 229

## Другие версии с тем же именем
- [markitdown · k-dense-ai](https://affpapa.org/nevibecode/skills/markitdown.md) — 2100 установок

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md