AIKraft/Skills/markitdown

markitdown

Конвертирует разнородные документы и URI в Markdown с помощью Microsoft MarkItDown для анализа, поиска и загрузки в LLM/RAG. Поддерживает локальное преобразование, потоки, форматы Office/PDF/данных, пакетные процессы, плагины, OCR и Azure.

KDK-Dense official Документы ★ 47.7k

Что делает навык

MarkItDown — это утилита Microsoft для преобразования разнородных документов (PDF, Office, HTML, CSV и др.) в структурированный Markdown, оптимизированный для индексации, поиска и загрузки в LLM/RAG. Skill обеспечивает безопасное извлечение текста из локальных файлов, потоков и URI, поддерживая OCR и облачные сервисы через плагины.

Когда применять

  • Конвертация локальных документов (PDF, DOCX, XLSX) в Markdown для анализа или добавления в базу знаний RAG.
  • Пакетная обработка директорий с документами для создания индексов или литературы.
  • Извлечение текста из отсканированных PDF или изображений с использованием OCR-плагина или Azure Document Intelligence.
  • Безопасное преобразование удаленных URI в Markdown с валидацией источника.

Как работает

  1. Установить пакет markitdown[all] или необходимые extras в изолированной среде Python 3.12+.
  2. Выбрать метод конвертации: convert_local() для файлов, convert_stream() для байтов, convert_response() для HTTP или convert_uri() для доверенных URI.
  3. При необходимости явно подключить плагины (например, markitdown-ocr) или облачные сервисы (Azure).
  4. Выполнить конвертацию и получить результат через атрибут result.markdown.
  5. Проверить выходной файл на наличие текста, корректность структуры и отсутствие инъекций.
  6. Сохранить оригинальный документ как авторитетный источник.

Примеры запросов агенту

Конвертируй файл report.pdf в Markdown, используя метод convert_local, и сохрани результат в report.md.
Преобразуй отсканированный PDF в текст, используя плагин markitdown-ocr, так как встроенный конвертер не выполняет локальный OCR.
Выполни пакетную конвертацию всех PDF и DOCX файлов в директории papers/ с сохранением структуры поддиректорий.

Что понадобится

  • Python 3.12 и изолированное окружение (venv).
  • Пакет markitdown[all] или специфичные extras (pdf, docx и т.д.).
  • Для OCR: плагин markitdown-ocr или доступ к Azure Document Intelligence/Content Understanding.

Описание составлено по SKILL.md навыка, сверено 08.10.2026.

Как подключить

1Скачать навык
# возьмите папку навыка «k-dense-ai-markitdown» из репозитория: # https://github.com/k-dense-ai/scientific-agent-skills
2Положить папку с SKILL.md к навыкам ассистента
# положите папку навыка туда, где ассистент ищет skills: cp -r k-dense-ai-markitdown/ ~/.claude/skills/k-dense-ai-markitdown/

Навык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.