Автоматическая генерация HTML из Markdown в Kate с помощью Build и pandoc

Зачем это нужно

Лёгкие текстовые редакторы экономят ресурсы и уменьшают отвлекающие факторы. Но у Kate есть скрытые возможности: плагин Build позволяет запускать произвольные команды, поэтому мы можем автоматически прогонять текущий файл через pandoc и получать готовый HTML без выхода из редактора.

Что вам понадобится

• Kate с плагином Build (входит в стандартный пакет KDE).
• Установленный pandoc в системе (команда pandoc в PATH).
• Файл в Markdown, который вы редактируете в Kate.

Важно: pandoc должен быть доступен из той же среды, где запущен Kate (если Kate запущен из графической сессии, проверьте PATH или укажите полный путь до pandoc).

Активация плагина Build

1. Откройте меню “Settings”, затем выберите “Configure Kate”.
2. В левой колонке выберите “Plugins” — откроется менеджер плагинов.
3. Поставьте галочку у пункта “Build Plugin”.
4. Нажмите “OK”.

После включения внизу окна Kate появится панель “Build Output” — здесь будут настраиваться цели сборки (Build Targets).

Создание профиля Build для pandoc

1. Кликните на “Build Output” внизу окна Kate — откроется диалог управления задачами сборки.
2. Перейдите на вкладку “Target Settings”.
3. Нажмите кнопку “New” (зелёный плюс) и задайте имя цели, например: MD > HTML.
4. В секции быстрых команд удалите предзаполненные make / make clean и в поле “Quick compile” вставьте команду:

pandoc -r markdown -w html -o%f.html %f

• Объяснение: %f заменяется именем текущего файла, включая расширение. Поэтому для myfile.md результатом будет myfile.md.html.
• Опция -r markdown указывает входной формат, -w html — выходной HTML, -o задаёт имя выходного файла.

Совет: если хотите, чтобы итоговый файл имел расширение .html без дублирования, используйте более сложную оболочку (shell) с подстановкой имени без расширения. Пример для Linux/Unix — команда-обёртка:

sh -c 'out="${f%.*}.html"; pandoc -r markdown -w html -o"$out" "$f"' -- %f

(Вставьте эту строку в поле “Quick compile” только если Kate поддерживает запуск sh-подобной команды; в некоторых сборках требуется полный путь до /bin/sh.)

Привязка к сочетанию клавиш

Чтобы запуск был действительно быстрым, назначьте сочетание клавиш:

1. Откройте “Settings -> Configure Shortcuts”.
2. Найдите действие “Quick Compile”.
3. Кликните в колонке “Shortcut”, выберите «Custom», затем нажмите кнопку назначения (появится “None”).
4. Нажмите желаемую комбинацию — например, Ctrl+B. Подтвердите замену, если комбинация уже занята.

Теперь достаточно нажать Ctrl+B (или ваше сочетание), и Kate запустит pandoc по настроенной цели и покажет результат в папке с вашим файлом.

Отладка и ошибки

• Вкладка “Errors & Warnings” покажет стандартный вывод stderr/ошибки команды.
• Если вкладка “Output” пуста — команда, скорее всего, выполнилась успешно, и файл создан.
• Частые проблемы:
  • pandoc не найден: укажите полный путь к исполняемому файлу.
  • проблема с правами записи: проверьте права каталога, где лежит документ.
  • неправильная интерпретация %f: убедитесь, что Kate использует тот синтаксис плейсхолдеров (в разных версиях может отличаться).

Альтернативные подходы

• Использовать Makefile в проектной папке и в Build указать make (удобно для сложных сборок с CSS/шаблонами).
• Запустить watcher (fswatch/inotify) в отдельном терминале, который при сохранении файла автоматически вызывает pandoc.
• Использовать расширения в VS Code (Markdown Preview Enhanced) или Emacs (markdown-mode + pandoc) для встроенной конвертации и предпросмотра.

Быстрый чеклист перед публикацией

• Проверили, что pandoc доступен из среды Kate.
• Создан профиль Build с корректной командой.
• Протестировали сборку через “Quick Compile”.
• Назначили удобное сочетание клавиш.
• Убедились, что результат сохранён в нужной папке и имеет ожидаемое имя.

Шаблоны команд (cheat sheet)

• Базовый:

pandoc -r markdown -w html -o%f.html %f

• С указанием шаблона и внешнего CSS:

pandoc -r markdown -w html -o%f.html %f --template=default.html --css=styles.css

• Для вывода в PDF (через wkhtmltopdf или встроенный PDF-движок pandoc):

pandoc -r markdown -o%f.pdf %f

Критерии приёмки

• При нажатии Quick Compile в директории документа появляется HTML с ожидаемым содержимым.
• Сочетание клавиш запускает сборку без дополнительных действий.
• Если используется обёртка для удаления расширения — имя файла соответствует ожидаемому (например, myfile.html).

Когда эта методика не подходит (кейсы отказа)

• Вы строите сложную статическую страницу с множеством зависимостей (скрипты, сборщики): лучше использовать специализированный статический генератор (Hugo, Jekyll).
• Нужен live-reload и превью в браузере при каждом сохранении — проще настроить watcher или использовать редактор с встроенным предпросмотром.

Ментальные модели и рекомендации

• Модель “single-command”: если задача помещается в одну команду pandoc — Build в Kate идеален.
• Модель “pipeline”: если процесс требует нескольких шагов (минификация, копирование ассетов), храните логику в Makefile/скрипте и запускайте его через Build.

Короткий глоссарий

• pandoc — универсальный конвертер документов (Markdown ↔ HTML/PDF и др.).
• Build (в Kate) — плагин для запуска внешних сборочных команд.
• Quick Compile — быстрый запуск одной команды, настроенной в цели сборки.

Резюме

Включив плагин Build и настроив цель с командой pandoc, вы получите простой и быстрый способ конвертировать Markdown в HTML прямо из Kate. Назначьте сочетание клавиш, добавьте шаблон или CSS при необходимости, а для более сложных сценариев перенесите логику в Makefile или скрипт.

Ключевые шаги: включить плагин → создать цель MD > HTML → прописать команду pandoc → назначить сочетание клавиш → проверять сборку через панель “Build Output”.

Дополнительный ресурс: если нужно, можно автоматизировать имя выходного файла через оболочку, чтобы убрать двойное расширение — используйте sh-обёртку или Makefile.