Категории

HTML в PDF (Точное оформление)

Рендер HTML/CSS в PDF с точными колонтитулами и настройками печати

Этот инструмент рендерит HTML/CSS в PDF через headless-браузер для точной верстки.

Колонтитулы:

  • Пользовательские HTML-шаблоны
  • Используйте <span class="pageNumber"></span> и <span class="totalPages"></span>
  • CSS со встроенными стилями в колонтитулах

Параметры печати:

  • Форматы A4/Letter/Legal
  • Поля (мм)
  • Печать фонов и масштаб
  • Поддержка @page и @media print (включить "Предпочитать CSS размер страницы")

Ключевые факты

Категория
Document Tools
Типы входных данных
textarea, select, checkbox, number
Тип результата
file
Покрытие примерами
4
API доступен
Yes

Обзор

Инструмент для профессионального преобразования HTML и CSS в PDF-документы с использованием headless-браузера, обеспечивающий высокую точность верстки, поддержку колонтитулов и гибкие настройки параметров печати.

Когда использовать

  • Когда необходимо создать PDF-отчет с точным соблюдением стилей CSS и макета страницы.
  • При генерации документов с динамическими колонтитулами, содержащими номера страниц.
  • Для конвертации веб-страниц или сложных HTML-шаблонов в печатный формат с поддержкой фоновых изображений.

Как это работает

  • Введите ваш HTML-код в основное поле и добавьте необходимые стили в блок CSS.
  • Настройте параметры страницы: выберите формат, ориентацию и установите нужные отступы в миллиметрах.
  • При необходимости добавьте HTML-шаблоны для верхнего и нижнего колонтитулов, используя специальные теги для нумерации.
  • Запустите процесс рендеринга, чтобы получить готовый PDF-файл, соответствующий вашим настройкам.

Сценарии использования

Генерация корпоративных счетов и актов из HTML-шаблонов с фирменным стилем.
Создание печатных версий веб-отчетов с сохранением сложной верстки и графики.
Подготовка многостраничных документов с автоматической нумерацией страниц в колонтитулах.

Примеры

1. Генерация счета-фактуры

Контекст
Бухгалтерии требуется преобразовывать HTML-шаблоны счетов в PDF для отправки клиентам.
Проблема
Стандартные конвертеры искажают верстку и не поддерживают нумерацию страниц.
Как использовать
Вставьте HTML-код счета, задайте поля 15 мм и используйте шаблон колонтитула с номером страницы.
Пример конфигурации
pageSize: A4, marginTop: 15, marginBottom: 15, footerTemplate: '<div style="text-align:center">Стр. <span class="pageNumber"></span> из <span class="totalPages"></span></div>'
Результат
Получен PDF-файл с идеальной версткой и корректной нумерацией страниц.

2. Печать аналитического отчета

Контекст
Аналитик готовит отчет с графиками, которые должны быть напечатаны с высоким качеством.
Проблема
Необходимо сохранить фоновые цвета графиков и специфические отступы.
Как использовать
Загрузите HTML-отчет, включите опцию «Печать фона» и настройте масштаб для оптимального размещения контента.
Пример конфигурации
printBackground: true, scale: 1.0, landscape: false
Результат
PDF-документ с четкими графиками и сохраненным цветовым оформлением, готовый к печати.

Проверить на примерах

html, pdf

Связанные хабы

FAQ

Можно ли добавить номера страниц в PDF?

Да, используйте теги <span class="pageNumber"></span> и <span class="totalPages"></span> внутри HTML-шаблонов колонтитулов.

Поддерживает ли инструмент CSS-стили?

Да, вы можете добавлять пользовательские стили в поле CSS, а также использовать @media print для управления внешним видом при печати.

Как добиться точного размера страницы?

Выберите нужный формат (A4, Letter и др.) и активируйте опцию «Предпочитать CSS размер страницы», если вы задали его в коде через @page.

Почему фон элементов не отображается в PDF?

Убедитесь, что установлена галочка «Печать фона» в настройках инструмента.

Можно ли настроить задержку перед созданием PDF?

Да, используйте параметры «Ждать до» (например, networkidle0) и «Доп. ожидание» в миллисекундах для корректной загрузки всех элементов страницы.

Документация API

Конечная точка запроса

POST /ru/api/tools/html-to-pdf-precise

Параметры запроса

Имя параметра Тип Обязательно Описание
htmlContent textarea Да -
cssContent textarea Нет -
pageSize select Нет -
landscape checkbox Нет -
printBackground checkbox Нет -
scale number Нет -
marginTop number Нет -
marginBottom number Нет -
marginLeft number Нет -
marginRight number Нет -
headerTemplate textarea Нет -
footerTemplate textarea Нет -
mediaType select Нет -
waitUntil select Нет -
waitTime number Нет -
preferCssPageSize checkbox Нет -

Формат ответа

{
  "filePath": "/public/processing/randomid.ext",
  "fileName": "output.ext",
  "contentType": "application/octet-stream",
  "size": 1024,
  "metadata": {
    "key": "value"
  },
  "error": "Error message (optional)",
  "message": "Notification message (optional)"
}
Файл: Файл

Документация MCP

Добавьте этот инструмент к конфигурации сервера MCP:

{
  "mcpServers": {
    "elysiatools-html-to-pdf-precise": {
      "name": "html-to-pdf-precise",
      "description": "Рендер HTML/CSS в PDF с точными колонтитулами и настройками печати",
      "baseUrl": "https://elysiatools.com/mcp/sse?toolId=html-to-pdf-precise",
      "command": "",
      "args": [],
      "env": {},
      "isActive": true,
      "type": "sse"
    }
  }
}

Вы можете объединять несколько инструментов, например: `https://elysiatools.com/mcp/sse?toolId=png-to-webp,jpg-to-webp,gif-to-webp`, максимум 20 инструментов.

Если вы столкнулись с проблемами, пожалуйста, свяжитесь с нами по адресу [email protected]