Создание списков, ссылок и якорей с Markdown
Для задания списков из нескольких уровней нужно создавать их с новой строки и предварять символами табуляции. При этом каждый очередной элемент не должен отступать от соседнего более чем на один символ табуляции:
- первый_уровень_1 - второй_уровень_1 - третий_уровень_1
Если поставить после второго уровня еще один символ табуляции, то "второй_уровень_1" и "третий_уровень_1" не будут относиться к списку:
- первый_уровень_1 - второй_уровень_1 - третий_уровень_1
Из этого следует, если список имеет заданные уровни, которые должны располагаться друг под другом и где-то один уровень будет пропущен, то структура может нарушиться:
- первый_уровень_1 - третий_уровень_1 - первый_уровень_2 - второй_уровень_2
Если добавить вместо пропущенного "уровня" "заполнитель" (назовем его 'abs') с необходимым количеством знаков табуляции, то проблема будет решена:
- первый_уровень_1 - abs - третий_уровень_1 - первый_уровень_2 - второй_уровень_2
Знание последовательности задания разделов списка пригодится при разметке оглавления ноутбука со сложной структурой. Для того, чтобы сделать название ссылкой на раздел, заключите его в квадратные скобки, а рядом в круглых укажите ссылку со знаком # впереди:
- [первый_уровень_1](#первый_уровень_1) - abs - [третий_уровень_1](#третий_уровень_1) - [первый_уровень_2](#первый_уровень_2) - [второй_уровень_2](#второй_уровень_2)
Этот же трюк можно использовать для создания ссылки на внешний ресурс, только вместо конструкции с "#" в круглых скобках необходимо задать саму ссылку:
[ссылка_на_дзен](https://dzen.ru/id/5ee6f73b7cadb75a66e4c7e3)
В последующих статьях расскажу, как автоматизировать создание оглавления с учетом описанных наработок.