markitdown
Конвертирует разнородные документы и URI в Markdown с помощью Microsoft MarkItDown для анализа, поиска и загрузки в LLM/RAG. Поддерживает локальное преобразование, потоки, форматы Office/PDF/данных, пакетные процессы, плагины, OCR и Azure.
Что делает навык
MarkItDown — это утилита Microsoft для преобразования разнородных документов (PDF, Office, HTML, CSV и др.) в структурированный Markdown, оптимизированный для индексации, поиска и загрузки в LLM/RAG. Skill обеспечивает безопасное извлечение текста из локальных файлов, потоков и URI, поддерживая OCR и облачные сервисы через плагины.
Когда применять
- Конвертация локальных документов (PDF, DOCX, XLSX) в Markdown для анализа или добавления в базу знаний RAG.
- Пакетная обработка директорий с документами для создания индексов или литературы.
- Извлечение текста из отсканированных PDF или изображений с использованием OCR-плагина или Azure Document Intelligence.
- Безопасное преобразование удаленных URI в Markdown с валидацией источника.
Как работает
- Установить пакет markitdown[all] или необходимые extras в изолированной среде Python 3.12+.
- Выбрать метод конвертации: convert_local() для файлов, convert_stream() для байтов, convert_response() для HTTP или convert_uri() для доверенных URI.
- При необходимости явно подключить плагины (например, markitdown-ocr) или облачные сервисы (Azure).
- Выполнить конвертацию и получить результат через атрибут result.markdown.
- Проверить выходной файл на наличие текста, корректность структуры и отсутствие инъекций.
- Сохранить оригинальный документ как авторитетный источник.
Примеры запросов агенту
Что понадобится
- Python 3.12 и изолированное окружение (venv).
- Пакет markitdown[all] или специфичные extras (pdf, docx и т.д.).
- Для OCR: плагин markitdown-ocr или доступ к Azure Document Intelligence/Content Understanding.
Описание составлено по SKILL.md навыка, сверено 08.10.2026.
Как подключить
SKILL.md к навыкам ассистентаНавык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.