Nested sections

This page lives in a nested subsection — authoring/advanced/ — so it is itself the live example the Navigation page points at. Open the sidebar: “Authoring Docs › Advanced › Nested Sections” is expanded because you’re on it.

How nesting works

Put a folder inside a section folder. plasmoid recurses to any depth: every folder becomes a collapsible group, every .md file an item.

authoring/
  navigation.md
  advanced/
    _category.toml          # title = "Advanced", order = 5
    nested-sections.md       # ← you are here
    assets-and-images.md

The output URL mirrors the folder path:

/<version>/en/authoring/advanced/nested-sections/

Each level configures itself

Every folder may carry its own _category.toml. The title and order position the group among its siblings; pages orders that group’s own items. Numeric NN- prefixes work at every level too and are stripped from the URL.

Auto-expanding the active trail

The sidebar groups render as native <details> elements. At build time, plasmoid adds the open attribute to the group containing the current page — and to all of its ancestors — so a reader always lands with their section expanded and their place visible. Everything else stays collapsed to keep a large tree scannable.

There is no JavaScript involved: it’s the browser’s built-in disclosure widget, which means it works with scripts disabled and is keyboard-accessible for free.

Keep it shallow where you can

Depth is supported, not mandatory. Two levels (section › page) suit most docs; reach for a third only when a section genuinely has sub-topics. Next door, Assets & images shows another authoring detail.