# markdown-converter

Переводит офисные документы, таблицы, PDF, разметку и медиафайлы в чистый Markdown прямо через uvx без ручной настройки парсеров.

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

## Что делает

Скилл вызывает утилиту `markitdown` через вызов `uvx --from "markitdown[all]" markitdown`. На первом запуске окружение кэширует зависимости, поэтому следующие конвертации идут быстрее. На выходе получается текст с сохранением исходной структуры: заголовков, списков, таблиц и ссылок.

Поддерживаются офисные файлы docx, pptx и xlsx, веб-страницы HTML, данные CSV, JSON и XML, а также книги EPub и архивы ZIP с обходом их содержимого. Для картинок скрипт достаёт метаданные EXIF и распознаёт текст через OCR, а для аудиофайлов извлекает теги и делает транскрипцию.

Если автоматическое определение кодировки даёт сбой на текстовом файле, нужно передать флаг `-c` с нужным чарсетом. Для сложных документов и сканированных PDF базового парсера может не хватить: тогда пригодится флаг `-d` для подключения внешнего распознавания через Azure Document Intelligence.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add steipete/agent-scripts --skill markdown-converter -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add steipete/agent-scripts --skill markdown-converter -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add steipete/agent-scripts --skill markdown-converter -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install steipete/agent-scripts markdown-converter
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add steipete/agent-scripts --skill markdown-converter -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/steipete/agent-scripts --path skills/markdown-converter
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add steipete/agent-scripts --skill markdown-converter -a opencode
```

### Claude.ai

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

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

## Когда брать
- перевести таблицы из Excel и CSV в Markdown-разметку
- разобрать презентации PowerPoint и документы Word для промптов
- распознать текст со сканов и картинок через OCR
- извлечь структурированный текст из EPub, HTML или архивов ZIP

## Примеры запросов агенту
- Конвертируй отчёт `report.docx` в Markdown и сохрани в `report.md`
- Преобразуй таблицу `data.xlsx` в Markdown через uvx markitdown
- Извлеки текст из сложного скана `scan.pdf` с флагом `-d`

## Похожие
- [convert-documents-to-markdown](https://affpapa.org/nevibecode/skills/convert-documents-to-markdown.md) — скилл · 12500 установок
- [markdown-to-epub-converter](https://affpapa.org/nevibecode/skills/markdown-to-epub-converter.md) — скилл · 696 установок
- [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 установки
- [markitdown](https://affpapa.org/nevibecode/skills/julianobarbosa-markitdown.md) — скилл · 1600 установок
- [paddleocr-doc-parsing](https://affpapa.org/nevibecode/skills/paddleocr-doc-parsing.md) — скилл · 471 установка

## Другие версии с тем же именем
- [markdown-converter · intellectronica](https://affpapa.org/nevibecode/skills/markdown-converter.md) — 1700 установок

Из того же набора: [steipete/agent-scripts](https://affpapa.org/nevibecode/by/steipete/agent-scripts.md) — 4 карточки

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

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