Аннотации

Использование аннотаций

Базовый синтаксис

Lorem ipsum dolor sit amet, (1) consectetur adipiscing elit.
{ .annotate }

1.  :man_raising_hand: Это аннотация! Может содержать `код`, **форматирование**, 
    изображения и любой Markdown-контент.

Результат:
Lorem ipsum dolor sit amet, (1) consectetur adipiscing elit.

1. Это аннотация! Может содержать код, форматирование, изображения и любой Markdown-контент.

---

Вложенные аннотации

Lorem ipsum dolor sit amet, (1) consectetur adipiscing elit.
{ .annotate }

1.  :man_raising_hand: Основная аннотация (1)
    { .annotate }

    1.  :woman_raising_hand: Вложенная аннотация

Результат:
Lorem ipsum dolor sit amet, (1) consectetur adipiscing elit.

1. Основная аннотация (1)

   1. Вложенная аннотация

---

В примечаниях (admonitions)

!!! note annotate "Заголовок с аннотацией (1)"

    Текст примечания с аннотацией (2)

1.  :man_raising_hand: Аннотация в заголовке
2.  :woman_raising_hand: Аннотация в теле

Результат:

Заголовок с аннотацией (1)

Текст примечания с аннотацией (2)

1. Аннотация в заголовке
2. Аннотация в теле

---

Во вкладках (content tabs)

=== "Вкладка 1"

    Текст с аннотацией (1)
    { .annotate }

    1.  :man_raising_hand: Аннотация во вкладке 1

=== "Вкладка 2"

    Другой текст (1)
    { .annotate }

    1.  :woman_raising_hand: Аннотация во вкладке 2

Результат:

Вкладка 1Вкладка 2

Текст с аннотацией (1)

1. Аннотация во вкладке 1

Другой текст (1)

1. Аннотация во вкладке 2

---

В других элементах

<div class="annotate" markdown>
> Цитата с аннотацией (1)
</div>

1.  :man_raising_hand: Аннотация для цитаты

Результат:

Цитата с аннотацией (1)

1. Аннотация для цитаты

---

Важные особенности:

1. Класс annotate добавляется к основному блоку
2. Нумерация аннотаций ((1)) ставится в нужных местах текста
3. Пояснения оформляются нумерованным списком после блока
4. Работает с: обычным текстом, цитатами, списками, примечаниями, вкладками
5. Для сложных элементов используйте HTML-обёртку <div class="annotate">