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