# markitdown

Скилл markitdown для Claude Code, который превращает документы, изображения, аудио и веб-страницы в Markdown для обработки языковыми моделями. Поддерживает больше 20 форматов и сохраняет структуру: заголовки, списки, таблицы и ссылки.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 1 установка · ★ 607 у репозитория
- Автор: jimmc414
- Лицензия: не указана · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/jimmc414/Kosmos/tree/HEAD/kosmos-claude-scientific-skills/scientific-skills/markitdown/SKILL.md
- Обновлён: 2026-10-09
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/jimmc414-markitdown

## Что делает

В основе — Python-утилита MarkItDown, которая принимает файл или URL и отдаёт чистый Markdown без временных файлов.

Конвертирует PDF, DOCX, PPTX, XLSX, HTML, EPUB, CSV, JSON и XML. Из изображений достаёт текст через OCR и EXIF-метаданные, из аудио делает транскрипцию — для этого нужен пакет `speech_recognition`. По ссылке на YouTube вытаскивает субтитры. ZIP-архивы разбирает целиком: все файлы внутри конвертируются и склеиваются в один результат.

Для сложных PDF можно подключить Azure Document Intelligence — тогда таблицы и разметка извлекаются точнее. Ещё есть режим описания картинок через GPT-4o: передаётся OpenAI-клиент, и изображения в презентациях превращаются в текст. Плагины расширения отключены по умолчанию из соображений безопасности — включаются флагом `enable_plugins=True`.

## Установка

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

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

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

### Codex

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

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

### Cursor

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

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

### GitHub Copilot

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

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

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

### OpenCode

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

### Claude.ai

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

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

## Когда брать
- вытащить текст из PDF или Office-файла
- сделать OCR изображения вместе с EXIF
- перегнать аудио в текст
- получить субтитры из YouTube по ссылке
- подготовить набор документов под RAG или эмбеддинги

## Примеры запросов агенту
- Сконвертируй `manual.pdf` в Markdown и сохрани результат в `manual.md`
- Достань текст из всех файлов в `documents/` и сложи в одну папку `markdown/`
- Распарси `archive.zip`, извлеки из него все PDF и переведи их в Markdown

## Похожие
- [pdf-to-markdown](https://affpapa.org/nevibecode/skills/pdf-to-markdown.md) — скилл · 870 установок
- [markitdown-skill](https://affpapa.org/nevibecode/skills/markitdown-skill.md) — скилл · ★ 108 у репозитория
- [convert-pdf-to-md](https://affpapa.org/nevibecode/skills/convert-pdf-to-md.md) — скилл · 138 установок
- [mineru](https://affpapa.org/nevibecode/skills/nebutra-mineru.md) — скилл · 19 установок
- [PDF.co](https://affpapa.org/nevibecode/mcp/pdfco.md) — MCP-сервер · ★ 9 у репозитория
- [doc-to-markdown](https://affpapa.org/nevibecode/skills/doc-to-markdown.md) — скилл · 945 установок

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

Из того же набора: [jimmc414/kosmos](https://affpapa.org/nevibecode/by/jimmc414/kosmos.md) — 2 карточки

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