Программа (CLI)ОфициальныйОткрытый код · MIT

MarkItDown

Документы, которые удобно читать ИИ

Извлекает содержимое PDF, Word, Excel и презентаций в Markdown — текст с заголовками, списками и таблицами.

На вашем компьютере
Ключ по желанию
Только читает
Бесплатно
Данные: локально; аудио — в Google

Используют с Claude Code, Codex, Hermes, OpenClaw — по открытым источникам. Сверено с документацией 29.09.2026.

Подключить через агента ↓Что можно сделать ↓Сайт проекта ↗

Пример задачи

Отчёт или презентация

Текст для анализа

Что можно поручить агенту

Подготовить отчёт для вопросов и ответов по его содержимому.
Собрать текст презентации в один файл.
Извлечь таблицы и разделы из документов для дальнейшего сравнения.

Подключить

Проще всего — отправить агенту ссылку: он прочитает инструкцию, установит, подключит и проверит сам.

Сообщение агенту

Подключи инструмент «MarkItDown» по инструкции: https://korra-agent.online/library/markitdown/agent.txt

Если агент не открывает ссылки — скопируйте задание целиком.

Попросите агента

Задание для агента

Подойдёт любой агент с доступом к терминалу: он проверит систему, установит программу и проверит работу.

Готовое задание с источниками, установкой и проверкой

Помоги настроить и использовать MarkItDown для задачи ниже.

Официальные источники — начни с них:
- Репозиторий MarkItDown: https://github.com/microsoft/markitdown
- Установка пакета markitdown и зависимостей форматов: https://github.com/microsoft/markitdown#installation
- Официальный пакет markitdown-mcp: https://github.com/microsoft/markitdown/tree/main/packages/markitdown-mcp
- README MCP-сервера: https://github.com/microsoft/markitdown/blob/main/packages/markitdown-mcp/README.md

Сначала прочитай инструкции по указанным ссылкам, определи мою систему и доступную тебе среду выполнения. Если инструмент уже установлен и подходит для задачи, используй его. Если источник недоступен, сообщи об этом. Если понадобится ключ или вход в аккаунт, не проси присылать его в чат: подскажи, куда его сохранить.

Установка и проверка:
Для обработки документа из терминала используй пакет markitdown в отдельном Python-окружении с зависимостями только для нужных форматов. Если я прошу подключение через MCP, используй официальный пакет markitdown-mcp и его README выше; способ регистрации выбери для моего агента. Перед изменением существующего MCP-конфига сохрани копию, затем проверь доступность инструмента сервера. Не подключай облачные сервисы автоматически.

Моя задача:
Подготовь мой документ для анализа с помощью MarkItDown. Попроси файл или путь к нему. Проверь установленный инструмент и зависимости для этого формата. Преобразуй документ локально в Markdown и сохрани рядом под новым именем. Исходник сохрани. Проверь, что заголовки, основной текст и таблицы извлечены; укажи заметные пропуски. Если это скан и текста нет, сообщи, что нужно распознавание. Не подключай облачные сервисы автоматически. Верни путь к результату.

В конце сообщи, что настроено, какую версию использовал, что проверил и где находится результат. Если запуск не удался, покажи конкретную ошибку.

Обычная программа: любой агент с доступом к терминалу установит её по заданию ниже.

Claude Code
Codex
Cursor
Hermes
OpenClaw
Korra

Claude Code — Статья: markitdown-mcp подключают к Claude Code командой claude mcp add и конвертируют PDF источник
Codex — LobeHub: отзывы агентов Codex — скилл markitdown установлен, CLI-тесты конвертации прошли источник
Hermes — Issue: в Hermes на Windows markitdown-mcp подключился сразу с 1 инструментом источник
OpenClaw — Issue: markitdown-mcp проверен как stdio-сервер для OpenClaw, xlsx/html выходят чисто источник

Что можно сделать

3 готовых сценариев. Каждый промпт можно отправить агенту после подключения.

Вопросы к длинному отчёту

Отчёт из PDF или Word становится текстом, и агент отвечает по нему с цитатами.

Заголовки, списки и таблицы сохраняются разметкой Markdown.
Обычное преобразование идёт локально; облачные функции включаются только отдельно.

Промпт для агента

Промпт

Помоги разобраться в длинном отчёте.
1. Попроси файл и 3–5 вопросов, на которые мне нужен ответ.
2. Преобразуй файл через MarkItDown локально и сохрани .md рядом с исходником.
3. Проверь, что заголовки и таблицы на месте. Если текста нет, скажи, что это скан.
4. Ответь на вопросы по тексту, к каждому ответу приложи цитату и название раздела.
Готово, когда на каждый вопрос есть ответ с цитатой или честное «в документе этого нет».

Совет. Важные числа и таблицы сверяйте с оригиналом: вёрстка при извлечении сохраняется не в точности.

Сравнить версии договора

Все отличия двух версий документа — по пунктам, с цитатами из обеих.

Обе версии переводятся в Markdown, и их можно сравнить построчно.

Промпт для агента

Промпт

Сравни две версии моего договора.
1. Попроси обе версии (Word или PDF) и уточни, какая новее.
2. Преобразуй обе через MarkItDown, сохрани в папку compare рядом с исходниками.
3. Найди все отличия: добавлено, удалено, изменено. Отдельно выдели суммы, сроки, штрафы и реквизиты.
4. Сохрани таблицу отличий в compare/diff.md с номером пункта и цитатами из обеих версий.
Юридическую оценку не давай. Готово, когда каждое отличие можно найти в исходных файлах.

Совет. Скан без текстового слоя MarkItDown не прочитает — для него нужно отдельное распознавание.

Папка документов для агента

Все PDF, Word, Excel и презентации из папки превращаются в Markdown, по которому агент ищет и отвечает.

Каждый файл конвертируется одной командой: markitdown файл -o результат.md.

Промпт для агента

Промпт

Подготовь мои документы, чтобы ты мог по ним искать.
1. Попроси путь к папке и уточни, какие там форматы.
2. Проверь, что MarkItDown установлен с зависимостями для этих форматов.
3. Преобразуй каждый файл локально в соседнюю папку markdown, сохраняя структуру папок. Исходники не меняй.
4. Составь markdown/index.md: файл, содержание в одну строку, заметные пропуски.
Готово, когда число файлов совпадает с исходным, а сбои перечислены отдельно.

Совет. Облачные расширения — Azure и расшифровка аудио — отправляют данные наружу. Для конфиденциальных документов оставайтесь в локальном режиме.

Если настраиваете вручную

Создайте отдельное Python-окружение и установите MarkItDown с зависимостями для ваших форматов по инструкции проекта. Команда ниже преобразует PDF с текстовым слоем в Markdown.

markitdown "report.pdf" -o "report.md"

Замените report.pdf на свой документ и выберите свободное имя результата. Полученный Markdown можно открыть текстовым редактором или передать своему ИИ-помощнику.

Открыть инструкцию проекта

Что учесть

Вёрстка не сохраняется в точности. Для сканов может потребоваться отдельное распознавание текста. Важные таблицы и числа нужно сверять с оригиналом.

Коротко об инструменте

Автор: Microsoft
Стоимость: Бесплатный локальный инструмент. Компьютер или сервер — ваш; услуги выбранного ИИ-агента могут оплачиваться отдельно.
Что потребуется: Python 3.10–3.14 и зависимости для нужных форматов. Можно запускать из терминала, Python или подключить отдельный MCP-сервер проекта.
Где обрабатываются данные: Обычное преобразование документов идёт локально. Расширение для расшифровки аудио отправляет звук в Google Web Speech API, облачные функции Azure подключаются по вашему выбору.
Проект: обновлён 21.09.2026 · ★ 187,5 тыс.
Направления: Документы Аналитика Автоматизация

Первоисточники

Описание сверено с документацией 29.09.2026. Собственная проверка запуска пока не проведена.

MarkItDown

Что можно поручить агенту

Подключить

Задание для агента

Что можно сделать

Вопросы к длинному отчёту

Сравнить версии договора

Папка документов для агента

Что учесть

Ещё может пригодиться