November 26, 2023

Создание списков, ссылок и якорей с 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)

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