Блоки кода

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

Блок кода объявляется как обычный код-блок Markdown с указанием языка, но с дополнительной переменной и подписью прямо в первой строке:

```python [CodeVariableName](Название блока)
print("Hello")
```

Здесь CodeVariableName — уникальная переменная, по которой можно будет сослаться на этот листинг из другого места текста, а текст в скобках — подпись, которая появится под блоком кода в готовом Word-документе.

Ссылка

Как и для остальных нумеруемых элементов, номер блока кода вставляется в текст через Liquid JS:

{{ CodeVariableName.index }}

При рендеринге вместо этой конструкции подставится актуальный номер листинга, который автоматически пересчитается, если вы добавите или удалите другие блоки кода выше по документу.