1. Базовое оформление
Поддерживается синтаксис Pandoc Markdown с расширениями. Ниже — элементы, которые корректно переносятся в PDF.
| Элемент | Синтаксис | Примечания |
|---|---|---|
| Заголовки | # … ###### |
H1 удаляется, если в YAML задан title. Кириллица в якорях
ссылок транслитерируется автоматически.
|
| Жирный / курсив | **жирный**, *курсив*, ***оба*** |
— |
| Зачёркнутый | ~~текст~~ |
— |
| Над- / подстрочный | ^верх^, ~низ~ |
— |
| Строчный код | `код` |
Моноширинный, выделен цветом. |
| Блок кода | ```язык … ``` |
Verbatim, мелкий шрифт. |
| Диаграмма Mermaid | ```mermaid … ``` |
Рендерится в картинку. Масштаб: ```mermaid{ width=70% }.
См. примеры ниже.
|
| Списки | - пункт, 1. пункт |
Вложенность и стили a., i. поддерживаются. |
| Списки задач | - [ ], - [x] |
— |
| Списки определений | Термин → новая строка → : определение |
— |
| Цитаты | > текст |
— |
| Таблицы | | a | b | |
Все колонки выравниваются по левому краю. |
| Ссылки | [текст](url) |
Ссылки на .md переписываются в .pdf. |
| Сноски | [^1] |
— |
| Изображения |  |
Центрируются; подпись курсивом под картинкой — тоже. |
| YAML frontmatter | --- title: … --- |
title становится заголовком; H1 в теле удаляется. |
| Формулы | $…$, \(…\), $$…$$, \[…\] |
Поддержка amsmath. |
| Raw LaTeX | \command{}, \begin{}…\end{} |
Для тонкого оформления. |
| Типографика | кавычки, тире, многоточие | Автоматически: «ёлочки», — тире, … |
2. Автоматические преобразования
Часть элементов изменяется или удаляется при конвертации — учитывайте это.
| Что | Поведение |
|---|---|
Эмодзи (:smile: или 😀) |
Удаляются полностью. PDF формируется без эмодзи. |
Стрелки → ← ↔ |
Заменяются на ASCII: ->, <-, <->. |
Ссылки на .md |
Переписываются в .pdf (для перекрёстных ссылок между документами). |
Raw HTML (<div>…) |
Не рендерится — XeLaTeX игнорирует HTML. |
| Колонки таблиц | Всегда выравниваются влево, независимо от заданного выравнивания. |
3. Готовые примеры
Можно копировать как заготовки (кнопка «Копировать» в углу блока).
Метаданные документа (заголовок)
--- title: Соглашение об интеграции --- Текст документа начинается здесь. Отдельный «# Заголовок» в теле не нужен — он будет удалён, так как заголовок берётся из title.
Диаграмма Mermaid с подписью
```mermaid flowchart LR KRU["КРУ-Коннект"] -->|"Интерфейс 1С-Коннект"| N8N["n8n"] N8N -->|"HTTPS, REST"| Pachka["Пачка"] ``` *Рисунок 1 — Схема интеграционного взаимодействия*
Изображение с подписью
 *Рисунок 2 — Подпись центрируется автоматически*
Таблица
| Параметр | Значение | |----------|----------| | Протокол | HTTPS | | Формат | JSON |
Формулы
Строчная: $E = mc^2$ или \(a^2 + b^2 = c^2\).
Блочная:
$$\int_0^1 x^2\,dx = \tfrac{1}{3}$$
4. Частые проблемы
Диаграммы Mermaid выводятся как текст, а не картинка
Чаще всего из-за переводов строк CRLF (Windows). Сервис нормализует загруженные
файлы автоматически, но если готовите конвейер сами — сохраняйте
.md
в кодировке UTF-8 с переводами строк LF. Также проверьте, что блок открыт ровно
как ```mermaid и закрыт ``` на отдельных строках.
Таблица выводится как текст с видимыми «|»
Строка-разделитель должна содержать дефисы для каждой колонки:
| --- | --- | --- |. Если в какой-то колонке дефисов нет
(например | - | | -- |), Pandoc не распознаёт таблицу. Сервис
автоматически чинит такие разделители при загрузке, но в исходнике лучше сразу
писать корректно.
Пропали эмодзи
Это ожидаемо: эмодзи удаляются намеренно. Используйте текст или символы вместо них.
Ссылка ведёт на .pdf вместо .md
Так и задумано для перекрёстных ссылок между конвертируемыми документами. Для
внешних ресурсов указывайте полный URL (
https://…) — он не меняется.
Изображения не находятся
Пути к картинкам должны быть относительными к
.md. Загружайте картинки
вместе с документом (несколько файлов или ZIP-папкой с сохранением структуры).
Двойной заголовок в начале
Если задан
title в YAML, не дублируйте его как # Заголовок
в теле — H1 при наличии title удаляется автоматически.