Найти в Дзене
Властелин машин

Создание списков, ссылок и якорей с Markdown

Для задания списков из нескольких уровней нужно создавать их с новой строки и предварять символами табуляции. При этом каждый очередной элемент не должен отступать от соседнего более чем на один символ табуляции:

-2

Если поставить после второго уровня еще один символ табуляции, то "второй_уровень_1" и "третий_уровень_1" не будут относиться к списку:

-3
-4

Из этого следует, если список имеет заданные уровни, которые должны располагаться друг под другом и где-то один уровень будет пропущен, то структура может нарушиться:

-5
-6

Если добавить вместо пропущенного "уровня" "заполнитель" (назовем его 'abs') с необходимым количеством знаков табуляции, то проблема будет решена:

-7
-8

Знание последовательности задания разделов списка пригодится при разметке оглавления ноутбука со сложной структурой. Для того, чтобы сделать название ссылкой на раздел, заключите его в квадратные скобки, а рядом в круглых укажите ссылку со знаком # впереди:

-9
-10

Этот же трюк можно использовать для создания ссылки на внешний ресурс, только вместо конструкции с "#" в круглых скобках необходимо задать саму ссылку:

[ссылка_на_дзен](https://dzen.ru/id/5ee6f73b7cadb75a66e4c7e3)

-11

В последующих статьях расскажу, как автоматизировать создание оглавления с учетом описанных наработок.

-12