Navigate a long Markdown document

A useful outline names the questions a reader will return to. Start with meaningful headings before adding a generated table of contents or dividing the file.

Build a navigable heading structure

# Ground station runbook

## Before a survey
### Verify instruments
### Confirm the launch window

## During collection
### Check incoming readings
### Respond to missing samples

## After collection
### Review the archive

Use one top-level title and nest subsections consistently. Heading size should reflect structure, not serve as a substitute for bold emphasis.

Open Navigator → Outline

1. Select Navigator in the document controls, then choose Outline. A keyboard can use ⌥⌘O.
2. Expand the relevant section and select a heading.
3. Use Search headings to locate a section by its name.
4. On a wide layout, pin Navigator when you want it to reserve space. Compact layouts present navigation differently.

Move one section at a time

Use the section name and previous/next controls in the document toolbar. With a keyboard, ⌥⌘[ and ⌥⌘] move through sections. Use Find for a phrase inside a section; heading search and document Find answer different questions.

Decide whether to split the file

Keep one file when the sections form a single reading sequence. Create linked supporting notes when they have independent purposes, owners or reuse. A file’s length alone is not a reason to create a complicated folder structure. After splitting, test relative links and attachment paths.