Иллюстрации

Иллюстрация оборачивает изображение или диаграмму TikZ подписью:

::::figure{#phase-portrait}
![Фазовый портрет затухающего маятника](https://example.com/pendulum.png)
 
Фазовый портрет затухающего маятника. Траектории закручиваются к началу
координат.
::::

Структура:

• Первый блок — содержимое иллюстрации: изображение или вложенная директива :::tikz (ограде figure тогда нужны четыре двоеточия; см. вложенность).
• Всё после него — подпись. Она рендерится под содержимым в стиле подписи и может содержать строчное форматирование и формулы.
• Необязательный {#id} даёт иллюстрации стабильный идентификатор для будущих перекрёстных ссылок. Выбирайте короткие осмысленные идентификаторы ({#fig-convergence}).

С диаграммой TikZ:

::::figure{#commutative}
:::tikz
\begin{tikzpicture}
  \node (A) at (0,1) {$A$};
  \node (B) at (2,1) {$B$};
  \draw[->] (A) -- (B);
\end{tikzpicture}
:::
 
Индуцированное отображение коммутирует с проекциями.
::::

Иллюстрации — для содержимого, на которое ссылается текст. Изображению, которое просто идёт по ходу изложения, обёртка не нужна — достаточно обычного синтаксиса изображений.