Списки

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

Маркированный список выглядит так:

- Первый пункт
- Второй пункт
- Третий пункт

А нумерованный — так:

1. Первый пункт
2. Второй пункт
3. Третий пункт

Практика использования

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

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