# Reading & writing

Use the outline sidebar

Last updated July 2026

Short answer: Unmarked's outline sidebar lists every heading in the document, nested by level. Click a heading and the document jumps straight to it. It's how you move around a long file without scrolling.

Each # heading becomes a line in the sidebar, indented under the section above it, so the structure of the document is right there on the left.

It mirrors the heading hierarchy. An # H1 sits at the top level, an ## H2 nests under it, an ### H3 under that, on down the levels. Headings are the spine of a Markdown file, and the outline reads that spine back to you.

Jump to a heading

  1. Open the outline sidebar.
  2. Find the heading you want in the list.
  3. Click it. The document scrolls to that heading.

That's the whole motion. No scrolling, no ⌘F, no hunting for the right paragraph. Click the section name, land on the section.

The outline works the same whether you're reading or writing. The list stays in sync with the file, so adding or removing a heading updates it. Seeing every heading nested in one column also makes a missing level or a section in the wrong place easy to spot.

Note: The outline is built from headings, so it's only as detailed as your headings are. It shines on a long spec, meeting notes with a heading per topic, or a README with a dozen sections; a document written as one long stretch of prose with no # lines won't have much of an outline. Add headings where the document changes subject and the sidebar fills in.

Unmarked is a free, private Markdown reader and editor for Mac. Read the story , or get in touch.