Claude жрёт токены на твоих PDF-ках

Что это такое

Одна страница PDF - это до 3 тысяч токенов

Шаг 0 · перед стартом

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

Шаг 1 · установка

Одна команда, и тула на месте

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 со списком опций. Значит, тула встала

Шаг 2 · использование

Кидаешь файл, получаешь чистый Markdown

Три способа сделать одно и то же

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

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

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

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

Работает не только с PDF. Word, Excel, презентации PowerPoint, картинки, аудио и даже ссылка на YouTube, тула вытащит транскрипт видео

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

Шаг 3 · автоматизация

Подключи тулу прямо к Claude, чтобы он конвертил сам

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

1. 01

   Поставь MCP-версию

   Скопировать

   pip install markitdown-mcp

2. 02

   Открой файл настроек Claude Desktop

   Он называется claude_desktop_config.json. На Mac лежит тут:

   Скопировать

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

   На Windows:

   Скопировать

   %APPDATA%\Claude\claude_desktop_config.json

3. 03

   Впиши блок 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"]
       }
     }
   }

4. 04

   Перезапусти Claude Desktop

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

Живой пример

20 страниц PDF, минус 70% лимита

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

Частые затыки и как обойти

Что меняется

Одна тула это только начало

Сохрани себе

Памятка по шагам

• 01 Поставь MCP-версию Скопировать pip install markitdown-mcp
• 02 Открой файл настроек Claude Desktop Он называется claude_desktop_config.json . На Mac лежит тут: Скопировать ~/Library/Application Support/Claude/claude_desktop_config.json На Windows: Скопировать %APPDATA%\Claude\claude_desktop_config.json
• 04 Перезапусти Claude Desktop Что увидишь: в интерфейсе появится значок инструментов, а MarkItDown в списке подключённых. Теперь можно просто кинуть файл и попросить «переведи в Markdown», Claude сделает сам