Skip to content

Headings in the Tree

Loud Outline reads a note's heading structure from Obsidian's own metadata cache — the same source the core Outline plugin and Quiet Outline use — so it always matches what Obsidian itself considers a heading.

Nesting

Headings nest strictly by level, not by any numbering scheme in the text:

# Overview          <- root
## Background        <- nests under Overview
### Details          <- nests under Background
## Next Steps         <- nests under Overview, not Background (a "##" always closes any deeper heading)
# Appendix            <- new root, sibling of Overview

produces:

Overview
├── Background
│   └── Details
└── Next Steps
Appendix

A heading always closes every currently-open heading at its level or deeper before it opens its own row — so a ## after an ###always ends up a sibling of the last ##, never a child of the ### above it, no matter how the file is otherwise organized.

What counts as a heading

Anything Obsidian's own metadata cache recognizes as a heading (# through ######, standard ATX-style Markdown headings). Loud Outline doesn't add its own heuristics — a line your notes, Obsidian's outline, and Quiet Outline all agree isn't a heading won't show up here either.

Files with no headings

If a file has no headings at all, it gets no collapse arrow from headings alone — unless it has tasks or lists at its root, which nest directly under the file itself. See Tasks and Lists.