MarkItDown: как превратить PDF в текст для Claude и сэкономить до 70% токенов в 2026

Ты кидаешь Claude PDF, а он через пару вопросов упирается в лимит. Причина простая: модель видит не аккуратный документ, а кашу из разметки, координат, картинок и служебных тегов. Всё это токены, а токены - твой лимит. Одна страница PDF съедает примерно 1,5-3 тысячи токенов, договор на 20 страниц доходит до 70 000 токенов только на то, чтобы Claude вообще увидел файл.

Лечится бесплатной тулой MarkItDown от Microsoft. Она берёт тот же файл и отдаёт чистый Markdown - родной язык нейросетей. Заголовки, таблицы, списки на месте, визуальный мусор выкинут. Тот же документ, но в 3-4 раза легче. Ниже по шагам: что нужно до старта, что вставить в терминал, как запустить и как подключить тулу прямо к Claude, чтобы он конвертил сам.

Почему Claude тратит столько токенов на PDF

Когда ты кидаешь Claude PDF, он не видит красивый документ. Внутри файла лежит разметка, координаты каждого элемента, картинки и служебные теги. Модель прожёвывает всё это целиком, и каждый кусок разметки - это потраченные токены.

Считаем на пальцах. Одна страница PDF - это примерно 1,5-3 тысячи токенов. Договор на 20 страниц вытягивает до 70 000 токенов, и это только чтобы Claude увидел файл, до вопросов дело ещё не дошло. Пять уточнений по документу, и лимит кончился.

MarkItDown берёт тот же файл и отдаёт чистый Markdown. Заголовки, таблицы, списки сохраняются, а визуальный мусор выкидывается. Claude отвечает точнее по простой причине: его тренировали как раз на Markdown, а сырой PDF для него чужой формат. Про то, как вообще устроены лимиты Claude Pro и на что уходят токены, есть отдельный разбор: лимиты Claude Pro и токены.

Тула бесплатная, с открытым кодом под лицензией MIT, живёт на GitHub с 168 тысячами звёзд. Работает прямо на твоём компьютере, файлы никуда не отправляются - для договоров и внутренних документов это важно.

Что нужно до старта

Все команды ниже ты вставляешь в терминал. Проще всего диктовать их Claude Code словами: это Claude прямо у тебя в компьютере, ему говоришь что сделать, а он сам ставит и запускает.

Если Claude Code ещё не стоит, поставь его сначала - там всё по шагам, и после установки все команды этой статьи можно просто проговаривать. Разбор для тех, кто не программист: Claude Code для не-программистов.

Ещё понадобится Python 3.10 или выше. Проверить версию можно командой python3 --version. Если версия ниже или Python не стоит вовсе, Claude Code поставит сам, просто попроси его словами.

Как установить MarkItDown одной командой

Установка сводится к тому, чтобы создать чистое окружение и поставить в него тулу. Окружение нужно, чтобы не сломать системный Python другими пакетами.

Для macOS и Linux вставь в терминал:

# создаём чистое окружение, чтобы ничего не сломать
python3 -m venv .venv
source .venv/bin/activate

# ставим MarkItDown со всеми конвертерами
pip install 'markitdown[all]'

# проверяем
markitdown --help

Для Windows команды чуть отличаются:

python -m venv .venv
.venv\Scripts\activate
pip install "markitdown[all]"
markitdown --help

Что увидишь: в терминале появится справка команды markitdown со списком опций. Значит, тула встала.

Как конвертировать PDF в Markdown

Дальше всё сводится к одной строке: кидаешь файл, получаешь чистый Markdown. Есть три способа сделать одно и то же, выбирай любой.

# сохранить результат в файл
markitdown file.pdf -o out.md

# то же самое, через перенаправление
markitdown file.pdf > out.md

# подать файл из stdin
cat file.pdf | markitdown

Что увидишь: рядом появится файл out.md - тот же документ, но чистым текстом. Открой его, скопируй содержимое и вставь в Claude. Контекстное окно останется маленьким, лимита хватит надолго.

Тот же приём работает и с другими форматами. Презентация, таблица, транскрипт видео - команда одинаковая, меняется только имя файла или ссылка:

markitdown презентация.pptx -o презентация.md
markitdown таблица.xlsx -o таблица.md
markitdown "https://youtu.be/xyz" -o транскрипт.md

Как подключить MarkItDown к Claude через MCP-сервер

До этого шага ты конвертил файлы руками и вставлял результат. Можно пойти дальше и сделать так, чтобы Claude Desktop сам конвертил файлы через MarkItDown, без терминала. Работает это через MCP-сервер - мостик, по которому Claude дотягивается до внешней тулы. Если хочешь понять, как вообще устроены такие расширения и скиллы для Claude, глянь разбор про плагины и скиллы Claude Code.

Сначала поставь MCP-версию тулы:

pip install markitdown-mcp

Дальше открой файл настроек Claude Desktop, он называется claude_desktop_config.json. На Mac лежит тут:

~/Library/Application Support/Claude/claude_desktop_config.json

На Windows путь другой:

%APPDATA%\Claude\claude_desktop_config.json

В этот файл впиши блок mcpServers. Простой путь - запуск локальной командой, сервер работает по stdio:

{
  "mcpServers": {
    "markitdown": {
      "command": "markitdown-mcp"
    }
  }
}

Если хочешь изолировать тулу в контейнере, чтобы она не мешалась с системой, есть вариант через Docker. Сначала собери образ из папки markitdown-mcp:

docker build -t markitdown-mcp:latest .

Потом впиши в конфиг Docker-вариант вместо простого:

{
  "mcpServers": {
    "markitdown": {
      "command": "docker",
      "args": ["run", "--rm", "-i", "markitdown-mcp:latest"]
    }
  }
}

Осталось перезапустить Claude Desktop. Что увидишь: в интерфейсе появится значок инструментов, а MarkItDown в списке подключённых. Теперь можно просто кинуть файл и попросить словами «переведи в Markdown», Claude сделает конвертацию сам.

Живой пример: 20 страниц договора и минус 70% лимита

Возьмём типичную картину. Утром прислали договор на 20 страниц. Раньше ты кидал его целиком в Claude, это примерно 70 000 токенов, и после пары вопросов лимит заканчивался.

Теперь одна команда: markitdown договор.pdf -o договор.md. Через пару секунд получаешь чистый Markdown - тот же договор, но в 3-4 раза легче. Скармливаешь его Claude, просишь найти все пункты про автопродление, получаешь ответ за один заход, и лимита остаётся на весь день.

На больших документах экономия доходит до 70%. По ощущениям это разница между «успел разобрать один файл» и «прогнал десять за то же время».

Если что-то пошло не так

Пара частых затыков, которые встречаются почти у всех, и как их обойти.

command not found: markitdown. Не активировано окружение. Запусти source .venv/bin/activate на Mac и Linux или .venv\Scripts\activate на Windows, и команда снова заработает.

Python 3.9 не поддерживается. Нужен Python 3.10 или выше. Попроси Claude Code обновить версию или поставь новее через pyenv install 3.12.

Пустой вывод после конвертации. Значит, PDF картиночный: внутри не текст, а фотографии страниц. Тут MarkItDown бессилен без OCR - нужен плагин распознавания, чтобы вытащить буквы из картинки.

Что ты собрал и что дальше

Смотри, что теперь есть. Инструмент, который превращает любой тяжёлый файл в чистый текст, стоит на твоём компьютере. Claude читает содержание, а не мусор разметки, и отвечает точнее. Лимит на больших документах экономится до 70%. А если подключил MCP, конвертация идёт вообще без терминала, прямо из чата.

MarkItDown - это одна деталь. Вокруг Claude таких деталей десятки: скиллы, MCP-серверы, настройки контекста. Каждая по отдельности мелочь, а вместе они складываются в рабочий конвейер, где документы, контент и автоматизация идут на потоке без слива токенов. Следующий логичный шаг - научить Claude правилам твоего проекта через файл настроек, чтобы он не переспрашивал одно и то же: как настроить CLAUDE.md.

Чек-лист: что у тебя теперь есть

• Python 3.10+ проверен, чистое окружение .venv создано
• MarkItDown установлен командой pip install 'markitdown[all]'
• Проверил установку через markitdown --help - справка выводится
• Умеешь конвертить PDF, Word, Excel, презентации и ссылки на YouTube в Markdown
• По желанию подключил markitdown-mcp к Claude Desktop через claude_desktop_config.json
• Знаешь, что делать при command not found и с картиночным PDF
• Кидаешь в Claude лёгкий Markdown вместо тяжёлого PDF и экономишь до 70% лимита