# Document Navigation

This page describes how to move around long previews: the Table of Contents, fast search, bookmarks, and the Mini Map. For scrolling shortcuts that apply everywhere (such as `J`/`K`), see Keyboard Navigation under Interface Features.

Contents

- Table of Contents
- Fast search
- Bookmarks and Mini Map

## Table of Contents

If your document has headers in it, a list button appears in the toolbar. Click it to expand the Table of Contents; click a headline to jump to that section of the preview. Use `J`/`K` (down/up) to move through the list, and `⌤` or `O` to jump to the highlighted header.

Filter bar: With the Table of Contents open, press `Space` (Space bar) to open the type-ahead field. Type any part of a headline name (Marked uses TextMate-style matching—for example you can type the first letter of each word) and press Tab (`⇥`) or the Down Arrow (`↓`) to move through the filtered list.

Pressing `⌘`+`T` also opens (or closes) the Table of Contents.

If “Headlines Collapse Sections” is enabled in the Marked Settings, General pane, holding the Command key while clicking an item in the Table of Contents will collapse or expand that section, revealing parent sections as necessary.

When in full-screen mode, the table of contents appears as a fixed side bar instead of a popup menu. To use that layout in a regular windowed preview, use the full-screen toggle in the lower-right of the TOC panel.

Toggle Full Screen

For a condensed list of keys, see Keyboard Shortcuts.

See also the Document Navigation video on YouTube.

### Full-screen mode for the Table of Contents

When a Marked preview window is full screen, the Table of Contents can stay fixed on the left for constant navigation. It still toggles with `⌘`+`T`; clicking outside the TOC often will not dismiss it while in this layout.

In a normal window, click the icon at the bottom of the TOC panel to dock it as a sidebar; click the icon at the top of the sidebar to return it to popup mode.

### Customizing where the TOC appears

The Table of Contents can be injected in the exported document using the special syntax `<!--TOC-->`.

Add `max#` (for example `<!--TOC max2-->`) to limit how many heading levels appear.

## Fast search

Fast navigation combines the Table of Contents with the filter focused so you can jump with minimal typing:

- Press `F` in the preview to open the TOC with the filter field focused (same idea as opening the TOC and then pressing `Space`, without the extra step).
- Type part of any headline title; the list filters to matches.
- If only one headline remains, pressing Return (`↩`) jumps straight to it.
- If multiple headlines remain, press Tab (`⇥`) to leave the filter field, move with `J`/`K` or the arrow keys, then press `O` or Return (`↩`) to go to the headline and close the TOC.
- Tab again returns focus to the search field.

> Shortcut reminder: Opening the TOC and pressing `Space` opens the filter bar—handy whenever the TOC is already visible.

(Earlier docs referred to this as “Fast Switcher”; it is the same feature.)

## Bookmarks and Mini Map

Use the Gear preview menu and `⇥` (`⇥`) focusing the document alongside search to place and revisit bookmarks while you skim.

### Setting bookmarks

Set bookmarks on scroll position using `⇧`+`1`–`⇧`+`9` and jump back using `1`–`9` alone. Use `N` and `P` for next/previous in document order; `⇧`+`N` and `⇧`+`P` for next/previous in numeric order.

Changing the Style or page size can move where a bookmark appears. Bookmarks are meant as temporary review aids: they do not persist between document sessions, but they do survive preview refreshes and edits.

Headline bookmarks: Hold Option and press `⌥`+`1`–`⌥`+`9` to bookmark the headline nearest the top of the viewport (or the last headline before the top).

Next free slot: `⌘`+`D` (or backtick ````, for vim users) adds a bookmark in the next available numbered slot.

Press `0` to expand the bookmark strip (headline titles where available). When the Mini Map is enabled, `0` shows it at the same time. Press Escape or `0` again to collapse.

Press `X` twice (`xx`) to clear all bookmarks.

There are more preview shortcuts; press `H` in the preview for a heads-up list, or `⌥`+`⌘`+`K` for the full reference.

### Mini Map

If the Mini Map is enabled in the Marked Settings, Preview pane settings, `0` opens a scaled thumbnail of the whole document along the bookmarks strip. Click anywhere on the map to scroll the full preview there. Saved bookmarks appear as horizontal lines with numbers (and headings when relevant).

Hold Command and move over the Mini Map for a magnified loupe; hold Option and drag to scroll as if dragging the scrollbar.

The map regenerates when the window size or layout changes. On very long documents, pressing `0` once may take a moment; Marked avoids building the Mini Map automatically on initial load until you request it.

Press `0` or Escape to close the Mini Map.

Performance note: Generating the map can briefly pause the preview on huge documents; this only runs when the map is visible or after a resize.

### Zoom overview (related)

For a text-scale overview without the Mini Map, see Zoom Overview (`Z`).

#### Next up: Wiki Navigation ▶

Support Site | Legal | Privacy