Обзор QuestPDF: генерация и обработка PDF из C# без HTML-рендера

QuestPDF — это не программа для открытия PDF и не визуальный редактор, а встраиваемая C#/.NET-библиотека, которая создаёт документы из кода и выполняет ряд операций над уже существующими PDF. Такое позиционирование определяет всё: пользователь работает прежде всего в IDE и исходном коде, а итоговый файл проверяет обычным PDF-просмотрщиком. Поэтому QuestPDF разумно оценивать как компонент серверного, настольного или автоматизированного .NET-решения, а не как замену Sumatra PDF, Adobe Acrobat или другому приложению с собственным редактором документов.

Скачать QuestPDF

Безопасный путь получения основной библиотеки — официальный пакет QuestPDF в NuGet. На дату подготовки обзора актуальна версия 2026.8.0. В типичном .NET-проекте пакет добавляется через менеджер NuGet в Visual Studio, Rider или совместимой IDE либо командой dotnet add package QuestPDF. Такой способ предпочтительнее случайных архивов и сторонних сборок: вместе с управляемой частью библиотека поставляет необходимые платформенные компоненты, а проект получает воспроизводимую запись зависимости.

Отдельно существует QuestPDF Companion App. Это вспомогательное настольное приложение для живого предпросмотра и инструментов диагностики макета. Официальная страница загрузки предлагает сборки для Windows, macOS, Debian- и Fedora-подобных Linux-сред; актуальная ветка Companion 2026.2.2 заявлена совместимой с библиотекой QuestPDF 2024.10.0 и новее. Старый пакет QuestPDF Previewer не надо путать с Companion: разработчик помечает Previewer как legacy-инструмент, заменённый Companion App и больше не поддерживаемый для новых функций.

Что такое QuestPDF

QuestPDF — специализированный движок компоновки документов для C#/.NET. Вместо преобразования HTML-страницы в PDF разработчик описывает структуру документа декларативным Fluent API: задаёт страницы, поля, колонки, таблицы, текст, изображения, повторяющиеся области и правила переноса. Код остаётся обычным C#, поэтому в шаблоне доступны типизация, методы, компоненты, условия, циклы, модели данных, тесты и стандартные средства рефакторинга IDE. Проект активно поддерживается; актуальный пакет 2026.8.0 опубликован 24 августа 2026 года.

Основная аудитория — разработчики, которым нужны счета, отчёты, сертификаты, выписки, накладные, каталоги, договорные приложения или массовые PDF-экспорты, формируемые из структурированных данных. QuestPDF не предназначен для интерактивного чтения книг, ручного выделения текста, OCR сканов или правки абзацев существующего документа мышью. Если задача заключается именно в просмотре готового файла, роль выполняет PDF-ридер; если требуется визуальная ручная правка, нужен редактор PDF или исходного документа.

Основные функции QuestPDF

Макет страниц и поток контента

Базовая модель строится вокруг страницы с настройками размера, ориентации, полей и зон header, content и footer. Для фона и переднего плана предусмотрены отдельные слоты, а Layers позволяет совмещать основной поток с фоновыми или накладываемыми элементами, в том числе водяными знаками. В наборе компоновки есть Column, Row, Table, List, Grid, Decoration, Inlined и Multi Column. Длинный контент может переходить на следующие страницы, а заголовки таблиц и повторяемые области — воспроизводиться там, где это предусмотрено выбранным элементом.

Текст, шрифты и графика

Текстовый API поддерживает стили, наследование оформления, выравнивание, номера страниц, гиперссылки и направление контента слева направо или справа налево. QuestPDF включает шрифт Lato как гарантированный базовый вариант и по умолчанию может видеть шрифты окружения. Для предсказуемого серверного вывода разработчик может отключить системные шрифты, положить нужные файлы рядом с приложением либо зарегистрировать их самостоятельно. Проверка наличия глифов доступна как диагностическая настройка: при включённой проверке отсутствие символа способно приводить к исключению вместо незаметной подстановки квадрата.

Для растровых изображений непосредственно поддерживаются JPEG, PNG, BMP и WebP. SVG вставляется как векторный ресурс отдельным API. Качество и размер можно балансировать настройками компрессии и целевого DPI; прозрачные изображения обрабатываются иначе, чем непрозрачные. С версии 2025.4.0 статические изображения, загружаемые по локальному пути, автоматически кэшируются, чтобы одно и то же изображение не приходилось повторно разбирать и встраивать при каждом использовании.

Генерация PDF, SVG и изображений

Основной выход — PDF. Результат можно записать в файл, поток либо получить как массив байтов, что удобно и для фонового сервиса, и для HTTP-ответа. Тот же документ можно вывести постранично в SVG или растровые изображения. Для растрового вывода доступны PNG, JPEG и WebP, а также параметры качества, DPI и прозрачного фона там, где формат поддерживает альфа-канал. В документации прямо оговорено, что не все PDF-специфичные функции обязаны иметь эквивалент в альтернативных форматах вывода.

XPS больше не следует считать поддерживаемым выходом. В release notes QuestPDF 2026.8.0 указано, что генерация XPS удалена из-за платформенной ограниченности, проблем рендеринга и низкого использования. Оставшиеся методы GenerateXps и GenerateXpsAndShow не возвращают прежнюю функциональность: для актуальной версии они приводят к ошибке компиляции, а код, собранный против старой версии, — к исключению во время выполнения.

Операции над существующими PDF

Начиная с ветки 2024.12 QuestPDF включает Document Operations на базе qpdf. API загружает существующий PDF и позволяет объединять документы, выбирать и переставлять страницы, накладывать и подкладывать PDF-контент, добавлять вложения, применять шифрование, расшифровывать и снимать ограничения при наличии законных оснований, а также сохранять результат. В актуальной документации перечислены 40-, 128- и 256-битные варианты шифрования с паролями владельца и пользователя и отдельными разрешениями на печать, извлечение, аннотации и другие действия.

Это расширяет QuestPDF за пределы чистой генерации, но не превращает библиотеку в универсальный редактор содержимого существующего PDF. В официальной дорожной карте программная инспекция и извлечение текста из входного PDF всё ещё обозначены как будущие направления. Поэтому сценарий «прочитать произвольный PDF, распознать его структуру и переписать отдельный абзац» нельзя считать базовой текущей возможностью.

PDF/A, PDF/UA и метаданные

Настройки документа включают профили PDF/A и PDF/UA, сжатие, качество изображений, DPI и направление контента. Официальный сайт перечисляет PDF/A-2a, PDF/A-2b, PDF/A-2u, PDF/A-3a, PDF/A-3b, PDF/A-3u и PDF/UA-1. Для PDF/A доступны вложения и расширение XMP-метаданных, что позволяет строить специализированные электронные документы, включая сценарии ZUGFeRD. Метаданные PDF можно заполнять полями заголовка, автора, темы, ключевых слов, языка и временных отметок.

Соответствие профилю нельзя сводить к одному флажку в коде: итог зависит от шрифтов, семантики, вложений и конкретного содержания. QuestPDF даёт механизмы генерации, но в производственном процессе разумно отдельно валидировать итоговый PDF профильным валидатором и тестировать его в целевых просмотрщиках.

Интерфейс и удобство использования

У основной библиотеки нет окна, меню и панели инструментов. Её «интерфейс» — это Fluent API внутри C#-кода. Сильная сторона подхода проявляется там, где шаблон документа живёт вместе с программой: автодополнение IDE показывает доступные элементы, компилятор ловит типовые ошибки, общий стиль можно вынести в методы и компоненты, а изменения проходят через обычный code review. Для разработчика .NET это обычно предсказуемее, чем поддержка большого HTML-шаблона с отдельным CSS-движком, но человеку без навыков программирования такой способ не подходит. Отдельной локализации интерфейса у библиотеки нет как категории: публичные имена API и официальная документация используют английскую техническую терминологию, а язык текста PDF задаёт приложение и доступные шрифты.

Порог входа состоит из двух частей. Первая — обычный C# и модель данных приложения. Вторая — правила компоновки QuestPDF: ограничения размера, поведение элементов при переносе, порядок вызовов и диагностика конфликтов. При несовместимых ограничениях библиотека умеет формировать подробные сообщения о проблеме макета, а режим отладки добавляет контекст расположения элементов. Это снижает цену поиска ошибок, но не отменяет необходимости понимать модель потоковой верстки.

Companion App добавляет визуальную часть разработки, не превращая документ в WYSIWYG-проект. Он показывает предпросмотр, умеет обновлять его вместе с изменениями кода, предоставляет увеличение, определение координат, измерение расстояний, просмотр структуры, поиск фразы и переход к реализации в IDE. Для интеграции используется ShowInCompanion; актуальная интеграция требует библиотеки не старее 2024.10. В режиме hot reload точность навигации по стеку может быть ниже, а для сложного документа сам Companion предупреждает о возможном ухудшении скорости обновления.

Поддерживаемые форматы и совместимость

На входе генератора находятся не «офисные документы», а данные и ресурсы приложения. QuestPDF напрямую принимает текст, шрифты и изображения; для растровой графики документированы JPEG, PNG, BMP и WebP, для векторной — SVG. Он не импортирует DOCX как редактируемый документ и не является движком OCR. Если исходником служит Word, Excel или скан, сначала нужен отдельный этап получения данных либо преобразования в формат, который ваша программа умеет обработать.

На выходе доступны PDF, постраничный SVG и постраничные растровые изображения PNG/JPEG/WebP. PDF остаётся главным форматом и единственным, для которого актуальны все функции стандарта, вложений, безопасности и документных операций. XPS в 2026.8.0 удалён. Для уже существующих PDF можно выполнять операции на уровне документа и страниц, однако универсального импорта содержимого PDF в собственную объектную модель редактирования нет.

Пакет 2026.8.0 содержит целевые сборки для .NET Standard 2.0, .NET 5, .NET 6, .NET 8 и .NET 10. NuGet вычисляет совместимость и с рядом других целевых фреймворков, но такой расчёт не равен гарантии работы на любой платформе: QuestPDF зависит от нативных компонентов рендеринга и обработки PDF. Официальное позиционирование текущей версии — Windows, Linux и macOS, а расширение списка платформ вынесено в roadmap.

Паспорт переноса данных

Производительность и стабильность

QuestPDF проектируется как движок массовой генерации, но производительность зависит от структуры документа, количества изображений, размеров шрифтовых наборов, выбранного DPI и степени параллелизма. Глобальное кэширование включено по умолчанию: документация отмечает, что оно обычно ускоряет расчёт компоновки ценой некоторого роста памяти. Аналогично более высокий DPI повышает детализацию растровых элементов, но увеличивает объём данных и потребление ресурсов.

В официальной дорожной карте разработчик относит к недавно поставленным улучшениям примерно 15-процентное ускорение генерации, около 85% снижения выделений памяти и заметно лучшее масштабирование по ядрам, вплоть до заявленного приблизительно четырёхкратного улучшения параллельного масштабирования. Эти цифры следует воспринимать как опубликованные разработчиком показатели его набора работ, а не как независимый универсальный бенчмарк: конкретный отчёт с большими фотографиями или сложным SVG может вести себя иначе.

Стабильность обновлений требует дисциплины. Security Policy говорит, что исправления безопасности поставляются только в последнюю стабильную версию, отдельные ветки исправлений для старых минорных выпусков не поддерживаются. Одновременно проект декларирует высокую обратную совместимость. Практический вывод — не оставаться годами на старом пакете, но и не обновлять производственный сервис без регрессионной проверки PDF. Удаление XPS в 2026.8.0 показывает, что редкие устаревшие возможности могут быть сняты даже при общей политике сохранения совместимости.

Лицензирование и версии

С 6 июля 2026 года действуют документы лицензирования версии 3.0. Community License бесплатна для подходящих категорий и предоставляет тот же основной набор функций, что платные уровни. К ней относятся индивидуальные пользователи и малые компании при годовой валовой выручке ниже 1 000 000 долларов США, подходящие благотворительные организации, академические учреждения и соответствующие условиям open-source проекты. Государственные и иные public-sector организации, кроме подходящих публичных академических учреждений, а также публичные компании не имеют права на Community License независимо от выручки.

Community License допускает коммерческое использование подходящими пользователями, не вводит водяные знаки, ключи активации, лимиты по серверам, проектам или количеству документов. При утрате права на Community License предусмотрен 90-дневный переходный период, за который нужно подтвердить сохранение права, приобрести требуемую лицензию либо прекратить использование. Для организации, которая не подходит под Community, оплачиваемое лицензирование требуется до производственного использования; отдельная evaluation-лицензия позволяет внутреннее тестирование и техническую оценку до 60 дней без production deployment.

Professional стоит от 1 999 долларов США плюс местные налоги и покрывает одно юридическое лицо, неограниченное число разработчиков, проектов, серверов и развёртываний. Enterprise стоит от 4 999 долларов плюс налоги, распространяет покрытие на аффилированные компании в определённой лицензией группе и добавляет более жёсткие условия поддержки и закупки. Число разработчиков в актуальной модели не переводит организацию с Professional на Enterprise: основное различие связано с юридическим охватом группы и корпоративными условиями.

Платная лицензия бессрочна для тех версий, которые стали доступны во время оплаченного периода. В покупку входит 12 месяцев обновлений и поддержки. Продление даёт следующие обновления и поддержку; при прекращении продления право использовать уже полученные в оплаченный срок версии сохраняется. На сайте указано ежегодное продление периода обновлений и поддержки, а не аренда, выключающая библиотеку после отмены.

Системные требования

.NET-проект

Для QuestPDF 2026.8.0 NuGet публикует сборки .NET Standard 2.0, .NET 5, .NET 6, .NET 8 и .NET 10. Выбирать следует TFM, уже используемый приложением, а не менять runtime только ради библиотеки без необходимости. На этапе сборки достаточно корректно восстановить NuGet-зависимости; на этапе выполнения важны совместимые нативные компоненты, которые QuestPDF применяет для рендеринга и операций с PDF.

Windows, Linux и macOS

Официальный сайт показывает Windows, Linux и macOS как основные платформы развёртывания. Для контейнера или сервера нужно тестировать именно конечный образ, а не только машину разработчика: различия системных библиотек, архитектуры и доступности шрифтов способны проявиться уже при старте нативной части. В минимальных cloud-образах часто мало шрифтов, поэтому наиболее воспроизводимый вариант — поставлять необходимые семейства вместе с приложением и явно управлять их регистрацией.

QuestPDF Companion App

Companion App распространяется отдельно для Windows, macOS, Linux Debian и Linux Fedora. Для macOS страница загрузки указывает 64-битные Intel и Apple ARM варианты. Текущий Companion 2026.2.2 заявлен для библиотек 2024.10.0 и новее; версия приложения не обязана совпадать с номером пакета QuestPDF. Legacy Previewer для новых версий использовать не следует.

Карта критических зависимостей

• .NET runtime и TFM: управляемая часть должна быть совместима с целевым проектом.

• Нативные библиотеки: QuestPDF использует Skia для рендеринга и qpdf для Document Operations; они выполняются локально вместе с приложением.

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

• Интернет: для самой генерации не нужен; сеть требуется только там, где её использует ваше приложение или внешняя интеграция.

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

• Companion App: нужен только для интерактивного предпросмотра; производственный процесс генерации от него не зависит.

Преимущества и недостатки QuestPDF

Плюсы и минусы

• Нативный для C# декларативный API без обязательной цепочки HTML/CSS → браузерный движок → PDF.

• Автоматическая потоковая компоновка, таблицы, повторяемые области, компоненты и нормальная интеграция с типизированной моделью приложения.

• Генерация в файл, поток и массив байтов удобна для ASP.NET, очередей задач и фоновых сервисов.

• Поддержка PDF/A и PDF/UA, метаданных, вложений и ряда операций над существующими PDF.

• Локальная обработка без телеметрии QuestPDF, сетевой активации и передачи документов разработчику библиотеки.

• Community License сохраняет полный набор функций для подходящих пользователей, а платные уровни не считают разработчиков, серверы и документы.

• Companion App дополняет кодовую модель живым предпросмотром и диагностическими инструментами.

Минусы

• Не подходит человеку, которому нужен визуальный редактор без программирования.

• Не является PDF-ридером, OCR-системой или универсальным редактором содержимого входных PDF.

• Исходный код доступен, но актуальная Community License не является OSI-open-source лицензией; условия необходимо проверять юридически.

• Есть нативные зависимости, поэтому одной совместимости TFM недостаточно для гарантии работы на любой .NET-платформе.

• Сложные документы требуют понимания правил компоновки, шрифтов и ограничений размеров; hot reload не устраняет архитектурные ошибки шаблона.

• Обновления безопасности выпускаются только в последней стабильной версии, что делает регулярное тестируемое обновление частью эксплуатации.

• XPS удалён в 2026.8.0, поэтому проекты, зависевшие от этого вывода, требуют миграции.

Сравнение с аналогами

Sumatra PDF находится на другом конце цепочки. QuestPDF создаёт или постобрабатывает файл в коде, а Sumatra PDF открывает готовый результат пользователю. Они не заменяют друг друга и могут использоваться вместе: сервис генерирует PDF через QuestPDF, а разработчик или пользователь просматривает его в Sumatra PDF. Для более функционального пользовательского чтения можно сравнить готовые ридеры, например Foxit Reader или Adobe Acrobat Reader.

Если задача состоит не в программной генерации, а в ручном редактировании существующего PDF, более уместен полноценный GUI-редактор — например класс решения, описанный в обзоре Adobe Acrobat Pro. Если нужен бесплатный настольный набор операций с PDF на Windows без программирования, полезно отдельно рассмотреть PDF24 Creator.

Инструкция по установке

Установка библиотеки в .NET-проект

Шаг 1. Проверьте целевой framework проекта и конечную ОС развёртывания. Для актуального пакета опубликованы сборки .NET Standard 2.0, .NET 5, .NET 6, .NET 8 и .NET 10.

Шаг 2. Добавьте официальный пакет QuestPDF через интерфейс NuGet вашей IDE либо выполните в каталоге проекта команду dotnet add package QuestPDF. Если нужна воспроизводимая сборка, зафиксируйте выбранную версию в проекте и обновляйте её отдельным изменением.

Шаг 3. В стартовом коде укажите применимый LicenseType: Community, Professional, Enterprise или Evaluation. Само значение не покупает и не подтверждает лицензию — оно должно соответствовать фактическому праву организации.

Шаг 4. Создайте минимальный документ с одной страницей и коротким текстом и сохраните его в PDF. На первом запуске это одновременно проверяет управляемую сборку, загрузку нативных библиотек и доступность базового шрифта.

Шаг 5. Откройте полученный PDF в независимом просмотрщике и проверьте страницу, текст, поля и свойства файла. После этого подключайте реальные данные, фирменные шрифты и изображения.

Подключение Companion App

Companion App ставится отдельно с официальной страницы QuestPDF для своей ОС. После установки в отладочном сценарии документ вызывается через ShowInCompanion вместо обычного сохранения на каждом цикле разработки. Для hot reload Visual Studio, Rider и dotnet watch используют собственные механизмы применения изменений; Companion лишь отображает новый результат и инструменты диагностики.

Удаление без повреждения проекта

Перед удалением сохраните шаблоны, тестовые PDF и информацию о версии пакета, если проект планируется мигрировать на другую библиотеку. В .NET 10 SDK ссылка на NuGet-пакет удаляется командой dotnet package remove QuestPDF; в .NET 9 SDK и более ранних используется форма dotnet remove package QuestPDF. После удаления восстановите зависимости и соберите проект: все места, использующие namespace и API QuestPDF, должны стать явными ошибками компиляции, которые и составят список миграции.

Обновление с запасным выходом

Шаг 1. До обновления зафиксируйте текущую версию NuGet и сохраните эталонный набор PDF для типовых и граничных документов.

Шаг 2. Обновите пакет в отдельной ветке и внимательно прочитайте release notes именно между вашей и целевой версиями. Для перехода на 2026.8.0 отдельно учитывайте удаление XPS.

Шаг 3. Сгенерируйте эталонный набор заново и сравните количество страниц, критические поля, шрифты, изображения, метаданные и профиль соответствия.

Шаг 4. Проверьте контейнер или серверный образ, а не только workstation: нативные зависимости и шрифты относятся к runtime-среде.

Шаг 5. Если регрессия критична, верните прежнюю зафиксированную версию пакета, пока несовместимость не разобрана. Для уязвимостей долгосрочно оставаться на старой ветке нельзя, потому что security fixes публикуются только в latest stable.

Практические кейсы

Счёт или акт из данных бизнес-системы

Цель. Превратить объект заказа, список позиций и реквизиты сторон в повторяемый PDF без ручной верстки каждого документа. Подготовка. Определите модель данных, обязательные поля, валюту, фирменные шрифты и формат страницы. Шаги. Вынесите шапку, таблицу строк, итоги и подвал в отдельные компоненты; соберите страницу через Column и Table; для заголовка таблицы используйте повторяемую область; результат записывайте в поток или файл. Проверка. Сгенерируйте документы с одной, десятками и сотнями позиций и убедитесь, что перенос строк не перекрывает подвал, итог не теряется, а номера страниц корректны. Ограничение. QuestPDF не проверяет бизнес-смысл суммы или НДС — расчёты должны быть корректны до передачи в шаблон.

PDF/A-3 с вложенным машинным файлом

Цель. Сформировать архивный PDF, содержащий визуальное представление и вложение с машинными данными. Подготовка. Выберите конкретный профиль PDF/A, подготовьте внедряемый файл, XMP-метаданные и шрифты. Шаги. Сформируйте визуальную часть, задайте PDF/A в DocumentSettings, добавьте вложение через Document Operations и необходимые метаданные. Проверка. Откройте PDF в независимом просмотрщике, убедитесь в наличии вложения и затем прогоните результат через профильный PDF/A-валидатор. Ограничение. Наличие настройки PDF/A в коде не заменяет внешнюю проверку соответствия нормативному профилю.

Пакетная сборка и защита готовых PDF

Цель. Объединить несколько готовых PDF, оставить нужные страницы и применить парольные ограничения. Подготовка. Убедитесь, что права на исходные документы позволяют обработку, определите порядок страниц и политику паролей. Шаги. Загрузите файлы Document Operations, выберите диапазоны, объедините их, затем настройте подходящий режим шифрования и разрешения. Проверка. Сверьте порядок и число страниц, откройте файл с пользовательским паролем, а ограничения проверьте в нескольких совместимых просмотрщиках. Ограничение. PDF-разрешения не следует считать DRM, гарантирующим невозможность копирования; это механизм стандарта PDF, поведение которого зависит и от просмотрщика.

Контроль перед сохранением и передачей

• Проверить число страниц и отсутствие неожиданно пустых листов.

• Проверить шрифты, кириллицу, спецсимволы и RTL-текст, если он используется.

• Просмотреть длинные таблицы на переносах страниц и повторении заголовков.

• Проверить итоговый размер файла и качество изображений при реальном масштабе просмотра.

• Для PDF/A или PDF/UA выполнить независимую валидацию, а не полагаться только на настройки генератора.

• Для защищённого PDF проверить пользовательский пароль, пароль владельца и реально требуемые разрешения.

• Открыть файл как минимум в одном независимом PDF-просмотрщике; для пользовательского сценария удобно использовать и Sumatra PDF.

• Для серверной генерации повторить тот же тест в контейнере или production-подобной среде со штатными шрифтами.

Навигатор по сбоям

Симптом: приложение не стартует после подключения QuestPDF. Сначала проверьте целевую ОС, архитектуру, опубликованный runtime и сообщение о загрузке нативной библиотеки. Если локально всё работает, а контейнер падает, сравнивайте именно runtime-образ и нативные зависимости. Контроль результата: минимальный документ должен успешно создаваться в целевой среде.

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

Симптом: LayoutException или сообщение о невозможной компоновке. Ищите конфликт минимальной/фиксированной высоты, ширины и содержимого. Упростите проблемный контейнер и используйте расширенную диагностику. Контроль результата: документ должен формироваться на гранично длинных данных, а не только на коротком примере.

Симптом: файл слишком большой. Проверьте размеры исходных изображений, DPI, качество компрессии и повторное использование ресурсов. Контроль результата: сравнивайте размер вместе с визуальным качеством и не снижайте DPI вслепую для печатных документов.

Симптом: после обновления исчез XPS. Это не повреждение установки: XPS намеренно удалён в 2026.8.0. Безопасное решение: перенести рабочий процесс на PDF либо временно закрепить прежнюю версию только как миграционную меру, учитывая отсутствие отдельных security-патчей для старых веток.

Часто задаваемые вопросы

QuestPDF — это бесплатная библиотека?

Для подходящих категорий да, по Community License. Критерий для обычного бизнеса — годовая валовая выручка ниже 1 млн долларов США, но существуют дополнительные правила и исключения. Public-sector организации и публичные компании обычно требуют платную лицензию независимо от выручки. Если организация не подходит, до production use нужна Professional или Enterprise.

QuestPDF остаётся open source?

Исходный код доступен публично, но текущая Community License прямо называет модель source-available и указывает, что это не OSI-approved open-source лицензия. Поэтому фраза «open source под MIT» применима только к историческому контексту старых выпусков и не должна использоваться для описания актуального 2026.8.0.

Нужен ли интернет для генерации PDF?

Нет. Библиотека выполняет генерацию внутри процесса приложения, не требует сетевой активации, не делает вызовы к серверам QuestPDF и не собирает телеметрию. Интернет может понадобиться вашему приложению для собственных данных, карт или иных внешних сервисов, но это уже не требование QuestPDF.

Есть ли лимит на число PDF или серверов?

Актуальная модель не вводит плату за документ, сервер или deployment. Community для подходящих пользователей и платные уровни допускают неограниченные проекты и развёртывания в пределах юридического охвата лицензии. Professional охватывает одно юридическое лицо, Enterprise — также определённые аффилированные структуры.

Можно ли использовать QuestPDF в ASP.NET?

Можно ли конвертировать DOCX в PDF?

Не как прямую функцию импорта. QuestPDF не является конвертером Word-файлов. Практический путь — извлечь или уже иметь данные в модели приложения и построить новый PDF-шаблон, либо использовать отдельный инструмент, который умеет корректно интерпретировать DOCX. Для ручной работы с офисными документами уместнее приложения класса LibreOffice Writer.

Может ли QuestPDF редактировать текст в существующем PDF?

Document Operations умеет работать с документами и страницами — объединять, выбирать, накладывать, шифровать, добавлять вложения. Но полноценное извлечение и структурная инспекция содержимого входного PDF обозначены в roadmap как будущее направление. Для интерактивной правки текста существующего PDF нужен другой класс инструмента.

Что произошло с QuestPDF Previewer?

Он заменён Companion App, начиная с поколения 2024.10. Previewer оставлен в документации для старых проектов, но не поддерживает новые возможности. Для современных версий следует использовать Companion.

Можно ли создавать XPS?

Как проверить, что обновление не сломало шаблоны?

Храните небольшой эталонный набор документов разных классов сложности, закрепляйте предыдущую версию пакета и после обновления сравнивайте страницы, шрифты, графику, метаданные и требуемые профили PDF. В CI полезно дополнить визуальные проверки структурными проверками данных и внешней валидацией PDF/A или PDF/UA там, где эти стандарты обязательны.

Вывод

QuestPDF 2026.8.0 хорошо подходит .NET-командам, которым нужно генерировать PDF как часть приложения, а не управлять отдельным визуальным дизайнером. Сильнейший сценарий — отчёты, счета, сертификаты и иные документы, где данные уже находятся в C#-модели, шаблон должен проходить code review, а результат требуется получать локально без облачного рендеринга и тарифа за документ. Дополнительные PDF Operations, профили PDF/A и PDF/UA и Companion App делают продукт заметно шире простого «рисования текста в PDF».

QuestPDF не подходит как замена Sumatra PDF, если пользователю нужно просто открыть и читать документ, и не заменяет визуальный PDF-редактор, если задача — вручную исправлять уже готовые файлы. В этих случаях разумнее выбрать ридер или GUI-редактор. Но когда PDF — программно формируемый артефакт бизнес-системы, а команда работает на C#/.NET, QuestPDF предлагает последовательно спроектированный кодовый путь от модели данных к воспроизводимому документу.