# Файл _index.md в каждом каталоге
<!-- @header-offset:4 -->

В конвейере Pandocster файл с именем **\_index.md** в каталоге
обрабатывается иначе, чем остальные Markdown-файлы: он считается
заголовком раздела и все файлы, лежащие рядом с **\_index.md** считаются
ему подчиненными, по этому уровень их заголовков отсчитываются
от уровня **\_index.md**.

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

## Зачем это нужно

Уровень вложенности (depth) в `pandocster.py` считается по относительному
пути файла: каждый каталог в пути даёт +1 к уровню. Этот уровень записывается
в комментарий `<!-- @header-offset: N -->` и используется фильтром
`header_offset.lua` для сдвига уровней заголовков (H1, H2, …) в итоговом документе.

Для файла **\_index.md** уровень намеренно уменьшается на 1.
То есть:

- `src/foo.md` → уровень 1;
- `src/section/bar.md` → уровень 2;
- `src/section/_index.md` → уровень 1 (как у корневого раздела), а не 2.

Так **\_index.md** воспринимается как «входная точка» раздела: его заголовки
не уходят глубже из-за того, что файл лежит в подкаталоге. Структура оглавления
остаётся ровной: раздел, начинающийся с _index.md, визуально на том же уровне,
что и разделы в родительском каталоге.

## Итог

Использование **\_index.md** в каталоге означает: «содержимое этого файла
относится к разделу с тем же уровнем вложенности, что и разделы на уровень выше».
Имя `_index` при этом можно трактовать как «индекс» или «вводная страница» раздела.
