Pandoc

Джон Макфарлейн и участники проекта · лицензия GPL-2.0-or-later

Переводит документы из формата в формат: Markdown в Word и PDF, Word в Markdown. Агенту нужен, чтобы отдавать результат так, как его ждут люди.

macOS · Windows · LinuxНа компьютере, на сервере и в контейнереБесплатно, GPL-2.0-or-later

Сверили официальные источники 25.09.2026. Не устанавливали и не запускали. Что именно проверяли

Установить агентом ↓

Какую задачу решает

Переводит документы из одного формата в другой. Агент пишет в Markdown, а людям нужен Word, PDF или страница: Pandoc собирает файл в нужном виде и разбирает Word обратно в текст, который агент может читать и править.

  • Собирает документ Word (docx) из текста агента: заголовки, списки, таблицы.
  • Переводит Word и HTML в Markdown, чтобы агент прочитал и поправил документ.
  • Делает PDF, если стоит программа для вёрстки PDF, обычно LaTeX.
  • Собирает электронную книгу EPUB и презентацию PowerPoint.

Пример результата

Говоришь агенту

Сделай из transcript.md документ Word, заголовки и списки сохрани.

Что получится

Рядом появляется transcript.docx с теми же заголовками, списками и таблицами. Его можно открыть в Word, Pages или Google Документах.

Паспорт

Кто делает
Джон Макфарлейн и участники проекта
Сайт
pandoc.org
Исходный код
github.com/jgm/pandoc
Инструкция
pandoc.org/installing.html
Лицензия
GPL-2.0-or-later
Версия
3.11 на 25.09.2026
Системы
macOS · Windows · Linux
Где работает
На компьютере, на сервере и в контейнере
Цена
Бесплатно
Проверка
Сверили источники 25.09

Установить агентом

Для Claude Code, Codex, Hermes и любого агента с терминалом
Установи программу «Pandoc». Работай по шагам и после каждого коротко говори, что сделал.

Что это за программа (каталог smyslokod.ru, официальные источники сверены 25.09.2026):
- официальный сайт: https://pandoc.org/
- исходный код: https://github.com/jgm/pandoc
- инструкция по установке: https://pandoc.org/installing.html
- актуальная версия на 25.09.2026: 3.11
- лицензия: GPL-2.0-or-later
- для работы нужно (в отдельных случаях): LaTeX (BasicTeX, TinyTeX или MiKTeX) - нужен только для PDF: полный MacTeX занимает около 4 ГБ, поэтому разработчики советуют облегчённые варианты

Правила:
1. Ничего не устанавливай и не меняй, пока я не скажу «да» на твой план.
2. Ставь только способами из этого промпта. Сторонние сборки, скрипты с форумов и из чужих репозиториев не бери.
3. Мои проекты не трогай: не меняй их файлы, виртуальные окружения и списки зависимостей (package.json, requirements.txt, pyproject.toml).
4. Команды с sudo, правку профиля оболочки (~/.zshrc, ~/.bashrc) и переменной PATH делай только после моего отдельного «да» на каждую.
5. Не проси у меня пароли и ключи и не выводи их. Если нужен пароль администратора, дай команду, я выполню её сам.

Шаги:
0. Определи, где ты работаешь: мой компьютер, сервер или контейнер. Какая система и процессор, какие менеджеры пакетов есть (Homebrew, apt, winget, uv, pipx). Ставить нужно туда, где ты сам запускаешь команды.
   - на компьютере: установщик или менеджер пакетов.
   - на сервере: пакет deb со страницы выпусков или архив; программа собрана статически и не тянет зависимостей.
   - в контейнере: в образ на Debian или Ubuntu - тем же пакетом deb. В образе Hermes Agent Pandoc нет; постоянные системные программы документация Hermes советует добавлять своим образом на основе официального.
1. Проверь, не стоит ли программа уже: pandoc --version. Если стоит и запускается, ничего не ставь и переходи к шагу 5.
2. Обязательных зависимостей у программы нет, то, что нужно в отдельных случаях, перечислено выше. Проверь свободное место на диске: нужно 25-45 МБ (столько весят установщики и архивы версии 3.11); для PDF ещё LaTeX, полный MacTeX около 4 ГБ, облегчённые варианты заметно меньше.
3. Составь план: каким одним способом из списка ниже будешь ставить, что появится на диске и сколько места займёт, что поменяется в системе и как потом удалить. Покажи план и жди моего «да».
   Способы из официальных источников:
   - macOS, Homebrew: brew install pandoc
   - Windows, winget: winget install --source winget --exact --id JohnMacFarlane.Pandoc
   - Linux, пакет deb: sudo dpkg -i pandoc-3.11-1-amd64.deb (файл скачать со страницы выпуска; для arm64 - pandoc-3.11-1-arm64.deb)
   - Linux, apt: sudo apt install pandoc (версия из репозитория может быть старше)
4. Установи по согласованному плану. Если что-то идёт не так, как в плане, остановись и спроси.
5. Проверь результат:
   - pandoc --version: программа запускается без ошибки;
   - Собери из маленького Markdown документ Word и разбери его обратно. Делай это во временной папке и не трогай мои файлы.
     printf '# Проверка\n\nТекст **жирным**.\n' > check.md
     pandoc check.md -o check.docx
     pandoc check.docx -t markdown
   - если ты работаешь в папке моего проекта, покажи git status: от установки в проекте не должно появиться изменений.
6. Итог одним сообщением: что установлено, какой версии и куда, сколько места заняло, что поменялось в системе и как всё удалить (macOS, Homebrew: brew uninstall pandoc; Windows, winget: winget uninstall --id JohnMacFarlane.Pandoc -e; Linux, пакет deb: sudo dpkg -r pandoc; Linux, apt: sudo apt remove pandoc).

Если на любом шаге ошибка, не чини наугад: покажи текст ошибки и скажи, что, по-твоему, случилось. Частые проблемы: https://smyslokod.ru/cli/pandoc#problemy

Промпт собран из официальных инструкций, сверенных 25.09.2026. Агент сначала проверит, что уже стоит, покажет план с местом на диске и способом удаления и без твоего «да» ничего не поставит. Сами мы этот промпт на живой установке ещё не прогоняли.

Как ставят вручную

Способы из официальных источников, у каждого ссылка на первоисточник.

  • macOS · Homebrew · источник

    brew install pandoc

  • Windows · winget · источник

    winget install --source winget --exact --id JohnMacFarlane.Pandoc

  • Linux · пакет deb · источник

    sudo dpkg -i pandoc-3.11-1-amd64.deb

    файл скачать со страницы выпуска; для arm64 - pandoc-3.11-1-arm64.deb

  • Linux · apt · источник

    sudo apt install pandoc

    версия из репозитория может быть старше

Как удалить

  • macOS, Homebrew: brew uninstall pandoc
  • Windows, winget: winget uninstall --id JohnMacFarlane.Pandoc -e
  • Linux, пакет deb: sudo dpkg -r pandoc
  • Linux, apt: sudo apt remove pandoc

Что нужно для работы

  • LaTeX (BasicTeX, TinyTeX или MiKTeX) (в отдельных случаях) - нужен только для PDF: полный MacTeX занимает около 4 ГБ, поэтому разработчики советуют облегчённые варианты

Системы

  • macOS - установщик pkg для Apple Silicon и Intel, Homebrew или MacPorts.
  • Windows - установщик msi для x86_64, winget или Chocolatey.
  • Linux - пакет deb и архив для amd64 и arm64 со страницы выпусков или пакет дистрибутива.

Где запускать

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

  • На компьютере - установщик или менеджер пакетов.
  • На сервере - пакет deb со страницы выпусков или архив; программа собрана статически и не тянет зависимостей.
  • В контейнере - в образ на Debian или Ubuntu - тем же пакетом deb. В образе Hermes Agent Pandoc нет; постоянные системные программы документация Hermes советует добавлять своим образом на основе официального.

Сколько ресурсов нужно

Место на диске
25-45 МБ (столько весят установщики и архивы версии 3.11); для PDF ещё LaTeX, полный MacTeX около 4 ГБ, облегчённые варианты заметно меньше
Сеть
Только чтобы скачать программу.

Лицензия и платные замены

Лицензия GPL-2.0-or-later. Условия лицензии важны тем, кто распространяет Pandoc вместе со своим продуктом. Чтобы переводить документы у себя, делать ничего не нужно. Текст лицензии

Цена: Бесплатно

Платные замены

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

Бесплатные замены

  • LibreOffice - Офисный пакет. Переводит документы без окон командой soffice --headless --convert-to, но весит заметно больше Pandoc.

О чём помнить

  • Pandoc не читает старый формат Word .doc, только .docx. Старый файл сначала пересохрани в .docx.
  • PDF без программы вёрстки не соберётся: по умолчанию Pandoc делает PDF через LaTeX.

Частые проблемы

"pdflatex" not found. Please select a different --pdf-engine or install "pdflatex"

Не стоит LaTeX, через который Pandoc по умолчанию делает PDF. Поставь облегчённый LaTeX (BasicTeX или TinyTeX на Mac, MiKTeX на Windows) или выбери другой движок флагом --pdf-engine.

PDF с русским текстом не собирается, в ошибке Unicode character

Движок pdflatex, который стоит по умолчанию, плохо работает с кириллицей. Собирай через xelatex со шрифтом, где есть русские буквы: --pdf-engine=xelatex -V mainfont="Arial" (на Linux - любой установленный шрифт с кириллицей).

В Linux стоит старая версия Pandoc

Пакет в репозитории дистрибутива отстаёт от выпусков. Поставь свежий пакет deb со страницы выпусков.

Проверка

Сверили официальные источники 25.09.2026. Не устанавливали и не запускали.

Когда
25.09.2026
Среда
Официальные сайты, репозитории и реестры пакетов, без установки
Объём
Сверили официальные источники, программу не устанавливали
Что именно сделали
  1. github.com/jgm/pandoc: последний выпуск 3.11 от 29.08.2026; COPYRIGHT - GPL версии 2 или новее.
  2. Файлы выпуска 3.11: deb и tar.gz для amd64 и arm64, pkg и zip для macOS arm64 и x86_64, msi и zip для Windows x86_64; размеры 26-42 МБ.
  3. pandoc.org/installing.html: Homebrew, MacPorts, winget, Chocolatey, conda-forge, пакеты дистрибутивов; бинарники собраны статически; для PDF нужен LaTeX, полный MacTeX около 4 ГБ.
  4. Руководство MANUAL: форматы docx (не doc), EPUB, pptx; движок PDF по умолчанию pdflatex, шрифт mainfont для xelatex и lualatex.
  5. Исходный код Pandoc: текст ошибки при отсутствии движка PDF - not found. Please select a different --pdf-engine.
ДатаВерсияОбъёмГдеИтог
25.09.20263.11источникибез установкиполучилось

«Проверено» ставим, только когда сами поставили программу и прогнали её на задаче. Сверка ссылок и вывод версии так не называются.

Входит в подборки

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