Иллюстрации

Иллюстрация оборачивает изображение или диаграмму 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}
:::
 
Индуцированное отображение коммутирует с проекциями.
::::

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