
wkhtmltopdf — консольный конвертер, который получает HTML-файл или веб-страницу и печатает их в PDF через Qt WebKit. На XeonLive можно скачать wkhtmltopdf бесплатно, а затем настроить формат листа, поля, колонтитулы, оглавление, загрузку локальных ресурсов и ожидание JavaScript. Главное отличие от обычного PDF-редактора — документ формируется повторяемой командой, по этой причине инструмент в особенности удобен в серверных отчетах, счетах, инструкциях и других шаблонных задачах.
Что умеет wkhtmltopdf и как устроено управление
У wkhtmltopdf нет собственного окна с панелями, вкладками и кнопкой экспорта. Вся работа сосредоточена в терминале: имя программы, глобальные параметры, один или несколько объектов входа и путь к выходному PDF. Объектом служит обычная страница, обложка или автоматически создаваемое оглавление. Такой интерфейс непривычен после настольных редакторов, но он дает важное преимущество — одна и та же команда одинаково запускается ручным способом, из планировщика, веб-приложения и очереди заданий.
Внутри проекта важно различать две вещи. Сам конвертер отвечает за загрузку HTML и печать, а внешний шаблон определяет фактический вид документа. По этой причине качество итога зависит не только от параметров wkhtmltopdf, но и от печатного CSS, набора шрифтов, доступности картинок и того, успел ли JavaScript закончить построение страницы. Для базового понимания формата полезен отдельный разбор формата PDF: wkhtmltopdf создает готовый файл, но не превращается после этого в редактор страниц и объектов.
Командная строка вместо окна программы

Базовый синтаксис выглядит так: wkhtmltopdf [GLOBAL OPTION]... [OBJECT]... output.pdf. Глобальные параметры задают свойства всего документа, а параметры страницы относятся к конкретному входному объекту. Имя итога ставится последним. Эта логика в особенности важна в длинных командах: аргумент, расположенный не в своей области, не становится автоматически глобальным и способен примениться не к той части документа.
Минимальный рабочий набор состоит из трех элементов: вход, выход и корректная среда выполнения. Входом бывает локальный HTML, URL или стандартный поток. Выходом — файл либо стандартный поток. Перед тем как добавлять десятки параметров, стоит добиться предсказуемого итога на одной простой странице, а затем усложнять конфигурацию по одному блоку: сперва геометрия листа, потом ресурсы, затем JavaScript, колонтитулы и автоматизация.
- Для единичной локальной страницы достаточно команды wkhtmltopdf input.html report.pdf.
- Для удаленной страницы вместо файла указывают HTTPS-адрес, доступный из той же среды, где запущен процесс.
- Для составного документа добавляют несколько page-объектов, cover и toc в нужном порядке.
- Для серверной интеграции безопаснее передавать аргументы массивом процессу, а не собирать строку через shell.
У проекта есть существенное ограничение, которое нельзя игнорировать при выборе технологии: движок основан на старом Qt WebKit. Основной репозиторий wkhtmltopdf переведен в архив, а организация на GitHub отмечена как не поддерживаемая. По этой причине программу разумно рассматривать как зафиксированный инструмент для уже известных шаблонов и стабильных конвейеров, а не как современный браузер, который систематически получает поддержку новых CSS и JavaScript API.
Как установить wkhtmltopdf и проверить рабочую среду
Установка сама по себе не гарантирует одинаковый итог на рабочем компьютере и сервере. Важны конкретная сборка, доступные библиотеки, шрифты, сертификаты и переменные окружения пользователя, от имени которого выполняется генерация. Начальная проверка должна подтвердить не только запуск бинарника, но и простую конвертацию тестового HTML с кириллицей и картинкой.
Windows: установка и первый запуск



Порядок действий в Windows простой. Сперва запускают установщик подходящей разрядности, принимают лицензию и оставляют понятный постоянный каталог, к примеру C:\Program Files\wkhtmltopdf. Затем завершают установку и открывают новое окно PowerShell или cmd. В старом терминале переменная PATH может остаться прежней, по этой причине проверка непосредственно после установки в уже открытом окне часто дает ложную ошибку о неизвестной команде.
Первый тест: wkhtmltopdf --version. В ожидаемом выводе присутствует имя программы и версия. Для сборок, где необходим полный набор функций нескольких объектов, HTML-колонтитулов и оглавления, отдельно обращают внимание на пометку with patched qt. После этого создают файл smoke.html с doctype, meta charset=UTF-8, коротким русским текстом и простой таблицей. Команда wkhtmltopdf smoke.html smoke.pdf должна завершиться без критических ошибок, а файл — открыться в просмотрщике.
Следующий шаг — проверка картинки. Положите PNG рядом с smoke.html, добавьте обычный img и снова сформируйте PDF. В версии 0.12.6 локальный доступ к другим файлам заблокирован по умолчанию, по этой причине для ресурсов из файловой системы необходим осознанный доступ. Для тестовой папки применяйте wkhtmltopdf --enable-local-file-access --allow "C:\pdf-test" "C:\pdf-test\smoke.html" "C:\pdf-test\smoke.pdf". Разрешайте только каталог задания, а не корень диска.
PATH, версия и проверка конкретной сборки

Когда команда не находится, не переустанавливайте программу вслепую. Сперва проверьте, существует ли C:\Program Files\wkhtmltopdf\bin\wkhtmltopdf.exe. Потом запустите его по полному пути. Если полный путь работает, проблема лишь в PATH. Добавьте каталог bin в пользовательскую или системную переменную, откройте новое окно терминала и повторите wkhtmltopdf --version. Для службы, планировщика или веб-сервера надежнее хранить полный путь к бинарнику в конфигурации, потому что их окружение часто отличается от интерактивного пользователя.
Проверка версии необходима и после обновления ОС, контейнера или образа сервера. Одноименный пакет из репозитория Linux может быть собран без модифицированного Qt и иметь иной набор возможностей. По этой причине в производственном окружении фиксируют не только строку версии, но и источник пакета, контрольную сумму образа и эталонные PDF. Изменение шрифтов или системных библиотек тоже способно сдвинуть переносы строк и пагинацию, даже когда сам HTML не менялся.
На Linux выбирают пакет под конкретное семейство дистрибутива и архитектуру. После установки выполняют which wkhtmltopdf и wkhtmltopdf --version, затем запускают тест от имени той же учетной записи, которая будет создавать документы. Это принципиально: сервисный пользователь может не видеть домашние шрифты, прокси, сертификаты, временную папку или каталог шаблонов, доступные администратору.
Рабочая последовательность для сервера: 1) установить пакет и зависимости; 2) установить фиксированный набор шрифтов; 3) убедиться, что системное хранилище сертификатов доступно; 4) создать отдельную временную папку для задания; 5) выполнить короткую конвертацию под сервисной учетной записью; 6) проверить кириллицу, SVG или PNG и HTTPS-ресурс; 7) сохранить команду и итог как smoke-test. После обновления образа этот тест должен выполняться до возврата узла в очередь генерации.
Для контейнера не копируйте только бинарник. Необходимы его системные библиотеки, fontconfig, шрифты и сертификаты. Временный каталог лучше монтировать отдельно, ограничить размер и очищать после любого окончания задачи. Пользователь контейнера не должен иметь доступ к конфигурации приложения, секретам и домашним каталогам. Эти ограничения в особенности важны из-за предупреждения самого проекта: непроверенный HTML нельзя безопасно считать обычным текстом.
Как конвертировать HTML в PDF и настроить страницу
После проверки окружения переходят к шаблону. Самая надежная стратегия — сперва сделать корректный печатный HTML, а затем постепенно добавлять параметры wkhtmltopdf. Это дает понятную точку диагностики: когда браузерная печать уже аккуратна, легче увидеть, что именно изменил старый WebKit, поля страницы или smart shrinking. Для общего сравнения методов полезно держать под рукой руководство по преобразованию HTML в PDF.
Базовая команда, URL и проверка готового файла

Начните с локального файла. Команда wkhtmltopdf --encoding utf-8 input.html report.pdf передает HTML в движок и сохраняет PDF рядом с текущим каталогом. Если шаблон лежит в другом месте, применяйте абсолютные пути. Относительные пути безопасны только тогда, когда рабочий каталог процесса заблаговременно известен. Планировщик, веб-сервер и очередь заданий часто запускают процесс из другой папки, из-за чего локальные картинки и стили внезапно перестают находиться.
Пошаговая проверка итога: 1) не включайте --quiet на первом запуске; 2) дождитесь окончания процесса и запишите код возврата; 3) убедитесь, что файл существует и его размер ненулевой; 4) прочитайте первые байты и проверьте сигнатуру %PDF-; 5) откройте первую и последнюю страницу; 6) проверьте кириллицу, таблицы, картинки и ссылки. Сообщение Done полезно для человека, но автоматическая система должна принимать решение по коду процесса и проверке самого файла.
Для веб-страницы вместо input.html передают ее HTTPS-адрес и затем имя report.pdf. Перед запуском убедитесь, что эта страница доступна именно с сервера генерации. Открытие страницы на ноутбуке разработчика ничего не доказывает, если сервер находится в другой сети, применяет иной DNS или не доверяет корпоративному сертификату. Если страница авторизована, сперва проверьте ее без рендера тем же сетевым маршрутом, а потом добавляйте cookie или заголовки.
Когда HTML уже находится в памяти приложения, временный файл необязателен. Дефис обозначает стандартный поток: приложение пишет HTML в stdin, закрывает поток, а wkhtmltopdf читает его как вход. PDF тоже можно получить через stdout. В таком режиме бинарные байты нельзя преобразовывать в строку или смешивать с диагностикой. stderr читают отдельно. Для ответственного документа все равно лучше записать поток во временный файл, дождаться успешного кода, проверить PDF и лишь после этого отдавать пользователю.
Формат листа, поля, ориентация, DPI и масштаб

Формат и поля настраивают до тонкой верстки. Для обычного отчета можно начать так: wkhtmltopdf --page-size A4 --orientation Portrait --margin-top 15mm --margin-right 12mm --margin-bottom 18mm --margin-left 12mm input.html report.pdf. Потом откройте документ и проверьте самую плотную таблицу, страницу с крупной картинкой и место, где начинается новый раздел. Исправлять необходимо не только первую страницу — небольшое изменение ширины сдвигает строки и разрывы по всему документу.
Если необходим нестандартный носитель, применяйте --page-width и --page-height с явными единицами. Не смешивайте стандартный --page-size и пользовательскую геометрию без необходимости. Для этикеток и чеков миллиметры понятнее пикселей, потому что итог печатается физически. После генерации распечатайте контрольный прямоугольник без подгонки в просмотрщике и измерьте его. Так можно отделить ошибку PDF от масштабирования самого принтера.
DPI, --zoom и smart shrinking влияют на размеры, но их не стоит применять одновременно для маскировки широкой верстки. Сперва исправьте печатный CSS и ширину контейнера, потом выберите формат и поля. Если документ все еще чуть не помещается, примените один механизм коррекции и ещё раз прогоните набор эталонных страниц. Для строгих бланков полезно отключить интеллектуальное уменьшение и контролировать размеры через CSS; для архивной копии произвольной страницы автоматическая подгонка бывает практичнее.
Разрывы страниц лучше задавать в самом шаблоне. Для начала новой главы применяют page-break-before: always, для окончания блока — page-break-after, а для компактного элемента — page-break-inside: avoid. Последнее правило не может удержать на одном листе блок, который физически выше доступной области. У длинной таблицы не задавайте фиксированную высоту строк; разрешите перенос текста и применяйте thead для повторяемого заголовка. После изменения шрифта или ширины столбца снова проверяйте границы страниц.
Как подключить ресурсы, JavaScript, колонтитулы и защищенные страницы
Большинство сложных сбоев появляется не в самой команде печати, а при загрузке зависимостей. CSS, картинки, шрифты, API-обращения и скрипты должны быть доступны процессу wkhtmltopdf. В версии 0.12.6 чтение локальных файлов заблокировано по умолчанию. JavaScript включен, но движок не знает бизнес-сигнала готовности вашего приложения. Эти два факта определяют порядок настройки.

Для локальных ресурсов соберите все зависимости одного задания в отдельную папку. К примеру, C:\pdf-job\ содержит report.html, style.css, logo.png и fonts. Запустите wkhtmltopdf --enable-local-file-access --allow "C:\pdf-job" "C:\pdf-job\report.html" "C:\pdf-job\report.pdf". Если картинка не появилась, проверьте фактический путь, права учетной записи и регистр имени файла. Не расширяйте --allow до всего диска: папка задания должна быть минимальным разрешенным пространством.
Для шрифтов применяйте гарнитуры, реально установленные на сервере, либо подключайте файлы через @font-face из разрешенной папки. Тестируйте normal, bold и italic отдельно. Если на сервере подменился шрифт, ширина строк меняется и документ получает другую пагинацию. Квадраты вместо отдельных символов обычно означают отсутствие глифа. Создайте короткую тестовую страницу с кириллицей, длинным тире, знаками валют и математическими символами и включите ее в smoke-test образа.
Динамическую страницу сперва проверяют без искусственной задержки. Если график или таблица пусты, включите --debug-javascript и посмотрите ошибки. Для простой асинхронной отрисовки подходит --javascript-delay 1500, но постоянная задержка ухудшает производительность и не гарантирует готовность при медленном обращении. Надежнее сделать в шаблоне явный сигнал: после загрузки данных и построения графиков присвоить window.status = "ready", а в команде применять --window-status ready. Внешний процесс все равно должен иметь общий тайм-аут.
Для печати закрытой страницы передавайте минимальные полномочия. --cookie name value устанавливает cookie; --cookie-jar читает и сохраняет набор cookies; --custom-header добавляет HTTP-заголовок; --username и --password поддерживают базовую HTTP-аутентификацию. Если custom header необходим ресурсам страницы, включают его распространение осознанно: заголовок авторизации не должен уйти на внешний домен вместе с картинкой. Для внутреннего отчета лучше применять короткоживущий токен лишь на чтение и ограничить сетевой доступ процесса нужным хостом.
Колонтитулы настраиваются в двух уровнях. Для простого номера страницы достаточно --footer-center "Страница [page] из [topage]" --footer-font-size 9 --footer-spacing 4. Для сложного фирменного блока применяют --header-html или --footer-html с отдельным минимальным HTML. Увеличьте соответствующее поле страницы так, чтобы колонтитул физически помещался, и только потом уменьшайте spacing. Проверяйте первую, десятую и последнюю страницу: длина номера меняется, и плохо рассчитанная сетка начинает сдвигаться.
Составной документ строится объектами. Команда wkhtmltopdf cover cover.html toc chapter1.html chapter2.html book.pdf последовательно добавляет обложку, оглавление и главы. Обложка не получает обычные колонтитулы и не входит в автоматическое оглавление. toc строится по HTML-заголовкам и outline; оформление оглавления настраивается XSLT. Сперва выгрузите стандартный шаблон через --dump-default-toc-xsl, сохраните копию и меняйте по одному правилу. После любого изменения полей, шрифтов и масштаба проверяйте номера страниц заново.
Для сложного отчета полезно хранить конфигурацию не одной строкой, а в явных смысловых группах: сперва параметры всего PDF, затем параметры обложки, основной страницы и оглавления, после них путь итога. Перед запуском валидатор отклоняет пустые размеры, неизвестную ориентацию и отрицательные поля. Такой порядок упрощает ревью и журналирование: из записи сразу видно, какая настройка относится ко всему документу, а какая только к отдельному объекту. Значения с пробелами передаются отдельными аргументами процесса, а не ещё раз разбираются оболочкой.
Как автоматизировать пакетную генерацию и ускорить работу
wkhtmltopdf хорошо встраивается в конвейеры именно потому, что вся конфигурация выражена аргументами процесса. Но автоматизация должна отделять входные данные, параметры печати, временные файлы и проверку итога. Сборка одной длинной shell-строки удобна лишь в ручном тесте; в коде она создает проблемы с пробелами, экранированием и командной инъекцией.
Для Python запускайте subprocess без shell=True и передавайте аргументы списком. В Node.js применяйте spawn, чтобы работать с потоками и не упираться в строковый буфер. В PHP указывайте полный путь к бинарнику для php-fpm и сопоставляйте окружение процесса с интерактивным терминалом. Во всех языках задавайте тайм-аут и параллельно читайте stderr. Если PDF идет через stdout, относитесь к нему как к бинарному потоку и не добавляйте текстовые сообщения.
При массовой генерации доступен --read-args-from-stdin. Каждая строка стандартного ввода воспринимается как отдельный набор аргументов, а это снижает накладные расходы повторного запуска. Такой режим подходит доверенной внутренней очереди с однородными шаблонами. Для независимых клиентских обращений отдельный процесс на документ обычно проще изолировать по памяти, времени и ошибкам. Параллелизм ограничивают реальными измерениями: тяжелый HTML, большие изображения и JavaScript быстро расходуют память.
Предварительная диагностика через wkhtmltoimage

В комплекте применяется wkhtmltoimage — отдельная команда на том же семействе технологий, которая сохраняет HTML в растровое изображение. Это удобный диагностический прием. Сперва сформируйте PNG из проблемного HTML и проверьте, появились ли стили, шрифты, картинки и JavaScript. Если изображение уже пустое, причина находится в загрузке ресурсов или рендере. Если изображение правильно, а PDF ломается, сфокусируйтесь на полях, разрывах страниц, колонтитулах и оглавлении.
Для пакетной системы полезно разделить профили. Профиль smoke генерирует одну маленькую страницу. Профиль visual создает изображение или одностраничный PDF для быстрой проверки рендера. Профиль production формирует полный документ с нумерацией, оглавлением и итоговой проверкой. Такой подход уменьшает время диагностики: нет необходимости всякий раз прогонять длинный отчет, чтобы понять, что сервер потерял шрифт или доступ к каталогу ресурсов.
Итог сперва пишите во временное имя, к примеру report.part.pdf. После успешного кода возврата проверьте сигнатуру, размер, количество страниц и контрольные данные, затем атомарно переименуйте файл. Клиент не должен получить документ в момент, когда процесс еще пишет последние объекты. После ошибки удаляйте временный PDF и каталог ресурсов. Повторяйте автоматически только сетевые и временные сбои; неверный аргумент, отсутствующий шрифт и ошибка шаблона повторятся без изменений.
Как находить ошибки и проверять качество готового PDF
Файл, который открылся, еще не обязательно корректен. Важные дефекты wkhtmltopdf часто проявляются как пропавшая картинка, другой перенос строки, неверный номер в оглавлении или пустой график. По этой причине диагностика строится от простого к сложному: сперва код возврата и stderr, затем структура PDF, потом визуальные эталоны и лишь после этого бизнес-проверка данных.
Сравнение рендера и финальная приемка

Для типичной ошибки сперва уберите --quiet и сохраните stderr. Сообщение о blocked access to file означает, что локальный ресурс не разрешен или путь вычислен неверно. Failed to load resource указывает на недоступный URL, сертификат, DNS, cookie или заголовок. Пустой JavaScript-график требует --debug-javascript, сигнала готовности или упрощения скрипта. Наложение колонтитула исправляют увеличением поля и только затем spacing. Чрезмерно мелкий текст диагностируют через ширину контейнера, smart shrinking, zoom и DPI, оставляя один механизм масштабирования.
На сервере с другой пагинацией сопоставьте шрифты и fontconfig. Один и тот же HTML с другим шрифтом получает иную ширину строк. Зафиксируйте файлы шрифтов в образе, локаль и параметры запуска, затем заново сформируйте эталон. Если процесс завершается с кодом 1, но PDF существует, не объявляйте задачу успешной автоматически. Выясните, какой ресурс вызвал ошибку, и заблаговременно определите политику: допустим ли документ без второстепенной картинки или весь отчет должен быть отклонен.
Автоматическая проверка минимум читает %PDF-, убеждается в ненулевом размере и успешном коде процесса. Для деловых документов добавьте количество страниц, ожидаемый формат листа и извлечение контрольного текста. Если отчет должен содержать номер, итоговую сумму или наименование раздела, ищите их в извлеченном тексте. Если применяется штрихкод или QR-код, полезно декодировать его из отрендеренной страницы. Только существование файла не проверяет смысл.
Визуальный регресс-набор должен включать короткий документ, длинную таблицу, кириллицу, специальные символы, картинки, колонтитулы, оглавление, ссылку, пустой набор данных и максимальную длину строки. После изменения шаблона, шрифта или образа сформируйте все эталоны и сопоставьте страницы. Пиксельное сравнение чувствительно к сглаживанию, по этой причине дополняйте его структурными проверками. Для оптимизации размера отдельно полезны рекомендации из материала о том, как сжать PDF без заметной потери качества.
wkhtmltopdf не найден после установки
Запустите бинарник по полному пути. Если он работает, исправьте PATH и откройте новый терминал. Для службы храните полный путь в конфигурации.
Картинки и CSS видны в браузере, но пропали в PDF
Проверьте абсолютные пути, права сервисного пользователя и локальный доступ. Для файлов применяйте --enable-local-file-access и --allow лишь на каталог задания.
JavaScript-график пустой
Включите --debug-javascript, отключите анимацию, задайте размер контейнера и дождитесь готовности через --window-status. Современные API старый WebKit не добавляет.
Колонтитул перекрывает основной текст
Увеличьте верхнее или нижнее поле, потом настройте header-spacing или footer-spacing. У HTML-колонтитула обнулите внешние margin.
На двух серверах различное количество страниц
Сопоставьте версии бинарника, шрифты, fontconfig, локаль и параметры запуска. Закрепите среду и прогоните один и тот же эталон.
PDF создан, но процесс завершился ошибкой
Считайте такой итог подозрительным: сохраните stderr, проверьте структуру PDF и выясните, какой обязательный ресурс не загрузился.
Для качества изображений не начинайте с глобального понижения всего документа. Уменьшайте фотографии до фактического печатного размера, следите за JPEG-качеством и не пережимайте схемы, QR-коды и мелкий текст. --image-dpi и --image-quality помогают уменьшить файл, но итог проверяют при увеличении и на печати. Если документ выглядит размытым, полезно свериться с отдельным руководством о том, как повысить качество PDF, и отделить проблемы исходной картинки от параметров самого конвертера.
Преимущества, недостатки, альтернативы и итоговые рекомендации
wkhtmltopdf по-прежнему удобен там, где уже существуют простые HTML-шаблоны и необходима воспроизводимая консольная генерация. Его сильная сторона — понятная модель командной строки, многолетняя совместимость с существующими интеграциями и богатый набор печатных параметров. Главный компромисс — устаревший WebKit и отсутствие активного развития основного репозитория, из-за чего современный фронтенд нельзя переносить в PDF без проверки.
Кому подходит такой рабочий процесс

Viviana Márquez, Medium
Инструмент подходит для счетов, актов, билетов, внутренних отчетов, экспортов из учетных систем и архивных копий, когда HTML контролируется разработчиком и не требует современных браузерных API. Он тоже удобен в старых проектах, где шаблоны уже стабилизированы и стоимость миграции выше пользы от нового движка. Для таких систем важнее зафиксировать окружение, набор шрифтов и эталонные документы, чем постоянно менять генератор.
Плюсы
- Полностью управляется из командной строки и легко встраивается в серверные процессы.
- Поддерживает формат листа, поля, ориентацию, колонтитулы, номера страниц, обложку, оглавление и несколько HTML-объектов.
- Умеет работать с URL, локальными файлами, stdin и stdout, что удобно для различных архитектур.
- Есть параметры для cookies, HTTP-заголовков, POST, прокси и ожидания JavaScript.
- При фиксированной среде дает воспроизводимый итог на давно отлаженных шаблонах.
Минусы
- Qt WebKit устарел, по этой причине современный CSS и JavaScript поддерживаются неполно.
- Основной репозиторий и организация проекта архивированы, активного развития нет.
- Нет визуального редактора: шаблон, пути, шрифты и ошибки приходится диагностировать через HTML, CSS и терминал.
- Безопасная работа с недоверенным HTML требует жесткой изоляции файловой системы, сети и прав процесса.
- Итог чувствителен к шрифтам и окружению; одинаковый шаблон на различных серверах способен получить другую пагинацию.
Кому не подойдет
- Командам, которые печатают React/Vue-приложение с современными API и сложной клиентской логикой без отдельного печатного шаблона.
- Издательским проектам с требованиями к современному paged media, продвинутой типографике, PDF/A или доступности из коробки.
- Пользователям, которым необходимо ручным способом исправлять готовый PDF, переставлять страницы, редактировать текст или подписывать документ.
Сопоставлять альтернативы лучше по типу исходника. WeasyPrint ориентирован на HTML/CSS и в особенности удобен для печатной разметки, которой не требуется JavaScript. Puppeteer PDF применяет современный Chromium и подходит динамическим страницам, которые должны сперва полностью отработать в браузере. Playwright решает схожую задачу в сценариях браузерной автоматизации. Prince силен в профессиональной HTML/CSS-верстке печатных документов, но относится к коммерческим решениям.
Если задача начинается уже с готового PDF, а не с HTML, wkhtmltopdf не дает преимуществ. Для ручного редактирования, перестановки страниц и исправлений необходим профильный редактор; на XeonLive есть отдельный обзор PDF Commander. Если требуется просто создать PDF из обычного документа или изображения, рациональнее начать с общего руководства по созданию PDF-файла, а не строить HTML-конвейер.
Практическая рекомендация для нового проекта однозначна по критерию рендера: wkhtmltopdf выбирают лишь после проверки, что шаблон в самом деле укладывается в возможности старого WebKit и что команда устраивает по безопасности и сопровождению. Для существующей системы с годами проверенных бланков миграция не обязательна сама по себе — сперва зафиксируйте среду, добавьте регресс-набор и измерьте реальные проблемы. Для нового интерфейса, который зависит от современного браузера, сразу оценивайте Chromium-инструменты; для печатной типографики без JavaScript — решения, ориентированные на paged media.
Вне зависимости от выбранного движка, надежный процесс выглядит одинаково: входные данные валидируются, шаблон имеет отдельные печатные стили, шрифты и ресурсы фиксируются, секреты не попадают в командную строку и журналы, итог создается во временный файл, затем проверяется структурно и визуально. Именно эти шаги превращают единичную удачную конвертацию в устойчивую генерацию документов.