Пользовательские PDF-шаблоны: создание премиального брендированного отчета

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

В этом руководстве мы от начала и до конца разберем один полноценный пример: Aurelia — темный отчет по бренд-стратегии с заливкой на всю страницу. Такие документы агентства и консультанты отправляют клиентам, которые ожидают, что оформление результата будет столь же продуманным, как и сама работа. Следуйте этим шагам, и вы сохраните собственную версию в своем аккаунте, а также получите рецепт, который сможете адаптировать для счетов, презентаций, технических заданий и многого другого.

Готовый результат — сгенерирован из обычного Markdown с помощью вашего сохраненного шаблона.

Что мы будем создавать

Aurelia намеренно выглядит «дорого», и каждую деталь этого шаблона вы можете контролировать в конструкторе:

• Фон на всю страницу (full-bleed) — глубокий темно-синий градиент, доходящий до самых краев листа.
• Золотой текстовый логотип в шапке и небольшая строка о конфиденциальности с увеличенным межбуквенным интервалом.
• Типографика с засечками — контрастный акцидентный шрифт для заголовков и утонченный книжный шрифт для основного текста.
• Фирменная палитра — теплые золотые заголовки, кремовый основной текст, врезка с цитатой, подчеркнутая золотой линией.
• Реальная структура документа — краткое резюме, таблица матрицы позиционирования и дорожная карта — всё это стилизовано так, чтобы оставаться читаемым на темном фоне.

Перед началом работы

1. Войдите в свой аккаунт. Конструктор находится в разделе Dashboard → Template builder (Панель управления → Template builder).
2. Рекомендуется платный тариф. Создание и сохранение шаблонов бесплатно, но экспорт без водяного знака — и использование премиальных базовых шаблонов, таких как Executive, — требует платной подписки.
3. Подготовьте два файла:
   • Логотип или фирменное написание в формате PNG с прозрачным фоном. Широкий и невысокий логотип (например, 1200×170) отлично смотрится в качестве аккуратной шапки.
   • Необязательное фоновое изображение в портретном формате A4 (около 1240×1754). Лучше всего подойдет темный, низкоконтрастный градиент или текстура — пестрые фотографии будут мешать чтению текста.

Подсказка: нет под рукой фонового изображения? Обычный темный Цвет фона (Background color) также активирует премиальный темный стиль, описанный ниже, поэтому вы можете создать весь шаблон, ничего не загружая.

Шаг 1 — Откройте конструктор и назовите свой шаблон

Перейдите в Dashboard → Template builder. Вы увидите три области: Библиотека шаблонов (Template library) слева, Редактор макета (page canvas) по центру и Инспектор шаблона (Template inspector) справа, где и происходит всё редактирование.

В панели Инспектор шаблона:

1. В поле Имя (Name) введите Aurelia — Brand Strategy Report.
2. Добавьте краткое Описание (Description), чтобы потом легко его узнать.
3. В качестве параметра Базовый шаблон (Base template) выберите Executive — утонченную основу с элегантными линиями заголовков и строгим стилем таблиц.
4. Отметьте галочкой Установить как шаблон по умолчанию (Set as default template), если хотите, чтобы он автоматически выбирался в конвертере.

Конструктор из трех панелей. Все изменения в панели Инспектор шаблона мгновенно отображаются на странице.

Шаг 2 — Добавьте фоновое изображение на всю страницу

В панели Инспектор шаблона найдите раздел Оболочка страницы (Page shell). Он управляет внешней частью страницы — той, что доходит до краев листа.

1. В разделе Фоновое изображение (Background image) нажмите Загрузить фоновое изображение (Upload background image) и выберите ваше темное изображение формата A4. Оно автоматически заполнит страницу от края до края.
2. Оставьте все четыре значения отступов (padding) равными 0 — документ уже имеет комфортные поля внутри заливки.
3. Добавьте наложение (Scrim) — легкую полупрозрачную заливку поверх изображения, которая сохраняет читаемость текста. Установите Цвет наложения (Scrim color) на почти черный, например #05070F, и сдвиньте ползунок Интенсивность наложения (Scrim strength) примерно на 18%.

Нет картинки? Вместо этого установите Цвет фона (Background color) на глубокий темно-синий, например #070B18. В любом случае конструктор распознает темную страницу и автоматически уберет элементы базового шаблона, предназначенные для светлого фона (белые карточки цитат, зебровидную раскраску строк таблиц, приглушенные жирные акценты), чтобы ваши цвета выглядели чисто.

Оболочка страницы: фон на всю страницу плюс легкое наложение для читаемости.

Шаг 3 — Разместите логотип и нижний колонтитул

Не выходя из панели Инспектор шаблона, откройте раздел Брендинг (Branding):

• Название бренда (Brand name): Aurelia
• Подзаголовок (Subtitle): Brand Strategy Studio
• Текст нижнего колонтитула (Footer text): Aurelia Brand Studio · Confidential — это станет сквозным нижним колонтитулом, который будет печататься внизу каждой страницы.

Затем выберите блок Верхний колонтитул (Header) в панели Редактор макета. В панели Выбранный блок (Selected block) нажмите Загрузить изображение (Upload image) и выберите ваш PNG-логотип с прозрачным фоном. Он появится в виде аккуратной шапки в верхней части страницы.

Текст из раздела Брендинг используется в блоке Верхний колонтитул и сквозном блоке Нижний колонтитул страницы.

Шаг 4 — Настройте строку заголовка

Не снимая выделения с блока Верхний колонтитул, прокрутите панель Выбранный блок:

1. В поле Текст (Text) введите короткую, уверенную фразу: Brand Strategy Studio · Confidential.
2. Установите Цвет текста (Text color) на приглушенный теплый серо-золотой, например #A7A08B, чтобы он не бросался в глаза, а выглядел сдержанно.
3. Установите Выравнивание (Alignment) По центру (Center), чтобы текст располагался ровно под логотипом.
4. Добавьте небольшой Нижний отступ (Margin bottom, около 28), чтобы отделить Верхний колонтитул от заголовка документа.

Настройки Цвет текста и Выравнивание для каждого блока позволяют тексту в блоках Верхний колонтитул и Нижний колонтитул отлично смотреться на темном фоне.

Шаг 5 — Настройте премиальную типографику

Именно здесь шаблон перестает выглядеть как обычный документ и становится частью бренда. Откройте раздел Типографика (Typography) и настройте каждый элемент, используя выпадающий список Элемент (Element). Aurelia использует всего два шрифта — сдержанность воспринимается как премиальность.

Для каждой строки: выберите Элемент, укажите Шрифт (Font family), введите Размер шрифта (Font size), кликните на образец Цвет (Color) и задайте дополнительные параметры (Межбуквенный интервал — Letter spacing, Трансформация — Transform, Высота строки — Line height). Ключ к успеху темного шаблона — это Цвет. Задайте здесь светлые оттенки текста, и страница оживет.

Типографика для каждого элемента. Выберите Элемент, а затем настройте стиль только для него.

Шаг 6 — Предварительный просмотр, тестирование и сохранение

1. Разверните Exact PDF preview (Точный предпросмотр PDF) под панелью Редактор макета, чтобы увидеть достоверное отображение страницы.
2. Протестируйте на реальном контенте. Вставьте настоящий документ — заголовки, таблицу, цитату, списки — и убедитесь, что всё остается читабельным. Aurelia без проблем справляется с матрицей позиционирования и дорожной картой.
3. Нажмите Сохранить шаблон (Save template). Теперь он появится в вашей панели Библиотека шаблонов и готов к использованию где угодно.

Реальный контент — таблицы, списки, жирные вводные фразы — стилизован так, чтобы оставаться четким на темном фоне.

Шаг 7 — Использование шаблона в конвертере

1. Откройте конвертер (ссылка Convert или кнопка Открыть конвертер (Open converter) в конструкторе).
2. Вставьте или напишите свой Markdown-текст.
3. В разделе Сохраненные шаблоны (Saved templates) выберите Aurelia — Brand Strategy Report.
4. Нажмите Скачать premium PDF (Download Premium PDF).

Вот и всё — ваш Markdown превращается в полностью брендированный отчет без водяных знаков.

Шаг 8 — Автоматизация с помощью API

Как только шаблон сохранен, вы можете генерировать такие же брендированные PDF-файлы программно — это идеально подходит для превращения результатов работы ИИ, контента из CMS или регулярных отчетов в готовые для клиентов документы.

1. Создайте API-ключ. Перейдите в Dashboard → API keys и создайте ключ. Он начинается с mp_live_ и показывается только один раз, поэтому скопируйте его в надежное место.

2. Найдите ID вашего шаблона. Авторизовавшись в системе, откройте в браузере ссылку https://markdowntopdfconverter.com/api/custom-templates. В JSON-ответе будут перечислены все сохраненные шаблоны с их id — скопируйте нужный.

3. Вызовите эндпоинт конвертации. Отправьте ваш Markdown вместе с customTemplateId:

curl -X POST https://markdowntopdfconverter.com/api/v1/convert \
  -H "Authorization: Bearer mp_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "markdown": "## Northwind Outdoor — Brand Strategy\n\nYour report content in Markdown…",
    "templateId": "executive",
    "customTemplateId": "YOUR_TEMPLATE_ID",
    "filename": "northwind-brand-strategy",
    "options": { "pageNumbers": true }
  }' \
  --output northwind-brand-strategy.pdf

Тот же запрос на Node.js:

const res = await fetch("https://markdowntopdfconverter.com/api/v1/convert", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.MP_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    markdown: "## Northwind Outdoor — Brand Strategy\n\nYour report content…",
    templateId: "executive",
    customTemplateId: "YOUR_TEMPLATE_ID",
    filename: "northwind-brand-strategy",
    options: { pageNumbers: true },
  }),
});

const pdf = Buffer.from(await res.arrayBuffer());

В ответе придет сам PDF-файл (Content-Type: application/pdf). Передайте customTemplateId, чтобы применить ваш сохраненный дизайн; установите templateId на его базовый шаблон (в данном случае executive). Полный список параметров смотрите в документации API.

Советы по дизайну для премиального результата

• Максимум два шрифта. Сочетайте один акцидентный шрифт с засечками с одним книжным шрифтом с засечками (или чистым гротеском). Создавайте иерархию с помощью размера, насыщенности и цвета, а не за счет добавления новых шрифтов.
• Дайте странице дышать. Щедрый межстрочный интервал и легкое наложение фона делают для «премиальности» больше, чем любые лишние украшения.
• Делайте контраст осознанным. На темной странице оставьте самый яркий тон для заголовка документа, золото — для заголовков разделов, а мягкий грязно-белый — для основного текста.
• Только прозрачные логотипы. Текстовый логотип в формате PNG с прозрачным фоном аккуратно ложится на любой фон; логотип на белом фоне — нет.
• Тестируйте перед отправкой. Всегда проверяйте шаблон на реальном контенте — длинных заголовках, широких таблицах, блоках кода, — чтобы потом не было сюрпризов.

Что дальше

• Сравните шесть встроенных базовых вариантов в руководстве по сравнению шаблонов.
• Впервые в приложении? Начните с руководства для начинающих.
• Готовы к автоматизации? Изучите документацию API.