# ВОЗМОЖНОСТИ ГЕНЕРАТОРА

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

## Заголовки и абзацы

Заголовок раздела задаётся одним символом `#`, подраздел — двумя `##`, пункт —
тремя `###`. Обычные абзацы разделяются пустой строкой.

### Третий уровень

Полужирный и курсив в оформлении по стандарту отключены, поэтому `**жирный**` и
`*курсив*` выводятся как обычный текст.

## Списки

- первый элемент списка;
- второй элемент с вложенными пунктами:
  1. вложенный элемент, выводимый как «а)»;
  2. ещё один вложенный элемент.

## Таблицы

Обычная таблица (без подписи и номера):

| Столбец A | Столбец B | Столбец C |
|---|---|---|
| 1 | 2 | 3 |
| 4 | 5 | 6 |

Таблица с подписью и автоматическим номером (ссылка — @tbl:features):

::: table "Возможности оформления" id=features note="Состав приведён условно"
| Элемент | Синтаксис | Результат |
|---|---|---|
| Таблица | `::: table` | Таблица с подписью |
| Рисунок | `::: figure` | Рисунок с подписью |
| Формула | `::: formula` | Нумерованная формула |
| Примечание | `::: note` | Примечание |
| Определения | `::: definitions` | Список терминов |
:::

## Рисунки

Готовое изображение вставляется директивой `figure`; файл ищется относительно
каталога `paths.assets`. Пример — рисунок @fig:diagram:

::: figure "Готовое изображение" id=diagram file=images/diagram.png
а) функциональные блоки;
б) направления связей.
:::

Схема PlantUML рендерится автоматически из исходного файла `.puml` — рисунок
@fig:flow:

::: figure "Схема PlantUML" id=flow file=images/flow.puml
:::

## Формулы

Формула с автоматическим номером и списком пояснений:

::: formula id=efficiency
K = (T_base - T_new)/T_base
:::

::: where
K — коэффициент снижения затрат;
T_base — исходное значение показателя;
T_new — достигнутое значение показателя.
:::

Ссылка на формулу: @eq:efficiency.

## Примечания и определения

::: note
Одиночное примечание к тексту.
:::

::: notes
- первое примечание;
- второе примечание.
:::

::: definitions
Термин — краткое определение термина;
Второй термин — ещё одно определение.
:::

## Перекрёстные ссылки

Записи @fig:diagram, @tbl:features и @eq:efficiency подставляют актуальные номера
рисунка, таблицы и формулы. Ссылки на источники оформляются как [@1] или
[@2, с. 10].

## Разрыв страницы

::: pagebreak
:::

Тематический разрыв `---` также трактуется как разрыв страницы.