# Interface Features

Flexibility is key.

Contents

- Gear Menu
- Keep on Top
- Window level defaults
- View Source
- Search
- Document navigation (TOC, bookmarks, Mini Map)
- Keyboard Navigation
- Full-Screen
- Clicking external links
- Collapsible headlines
- Custom Processor indicators/toggles
- Scroll To Edit
- Autoscroll
- Zoom Overview
- Markdown Reference
- Global Keyboard Shortcuts

## Gear Menu

The Gear menu provides most of the features found in the menubar, plus some preview-specific functions. Just click the gear in the lower right of the window to access these functions.

## Keep on Top

The lock icon in the lower left will bring the Preview window to the front and keep it there (float it) when switching to other applications. You can set a transparency on the window in the Marked Settings, General pane which will allow the window to fade when using other applications.

This feature can also be toggled with `⌥`+`⇧`+`⌘`+`F`.

## Window level defaults

In the Marked Settings, General pane you can use “Keep new windows on top” to set new windows to always remain above other windows, and/or set windows to rise to the top when their associated document is updated. Windows set to rise on update will not “steal focus” from your editor, they will only rise to be visible without becoming active.

## View Source

You can switch between preview and source code views with the button in the upper right corner. This view can also be toggled with `⌘`+`U`.

## Search

The find bar can be accessed with `⌘`+`F` and allows you to search through the preview for a word or phrase. Once you search, you can use `⌘`+`G` and `⇧`+`⌘`+`G` to navigate forward and backward through additional results.

The checkboxes on the right side of the search bar allow you to narrow the search down by case sensitivity, whole words only and regular expressions. In addition to regular expression search, wildcard (*?) searches always work, even when the regex option is off.

You can also surround a search term or phrase with slashes to interpret it as a regular expression automatically (e.g. ‘/term.+?\b/’).

Use the search feature in combination with bookmarking to save locations as you find them. Press Tab (`⇥`) to focus the document, then type Shift-[1-9] to set a bookmark on that number. You can jump back to the bookmark by just typing the number (without the Shift key), or by using n/p to navigate through them in document order. N/P will navigate in numeric order. For bookmarks, the Table of Contents, the Mini Map, and fast header search, see Document Navigation. See the Preview Navigation section for more options, or type “?” any time in the Preview.

> Note: The search cannot wrap between elements, meaning that a search string cannot continue between a paragraph and a headline, across list items, etc.

You can toggle the “Whole words,” “Case sensitive,” and “Regex” checkboxes using `⌃`+`⇧`+`1`, `2` and `3`, respectively.

### Advanced search ##

You can use wildcards in a non-regex search. `*` will match any series of non-space characters and `?` will match any single character.

Starting a search with a `*` will make it a jQuery selector search. You can use any jQuery selector and all matching elements will be highlighted and navigable with `⌘`+`G` and `⇧`+`⌘`+`G`. To limit the scope of a text search to a certain element type, add the search terms in double quotes after the selector definition:

    *h2 "Alice"

This is the equivalent of `*h2:contains(Alice)`

## Document navigation (TOC, bookmarks, Mini Map)

The Document Navigation page covers the Table of Contents (including opening the filter with `Space`), fast search with `F`, bookmarks, and the Mini Map.

## Keyboard Navigation

The preview window can be navigated quickly using keyboard shortcuts. Use `J` and `K` to move up and down, and hold down Shift (`⇧`+`J`/`⇧`+`K`) to move faster. `T` and `B` will move to the top and bottom of the document (as will `gg` and `⇧`+`G`, for Vim fans). `U` and `D` will move 1/2 page up and down.

### Header jumping

Pressing the comma (`,`) and period (`.`) keys will jump backward and forward through any headers in the document. Holding down Shift (`⇧`) will jump only between level 1 and 2 headers.

## Full-Screen

Full-screen mode can be toggled from the Preview menu or by typing `⌃`+`⌘`+`F`.

## Clicking external links

Clicking an external link in your document’s preview will open it in your default browser. If you click and hold, when you release Marked will give you three options: you can copy the link’s URL to your clipboard, validate the link, or open the link in your default browser. Just click anywhere in your preview to dismiss the window. This feature can be disabled in the Marked Settings, Preview pane (“Enable link popovers”).

See an overview video on YouTube.

## Collapsible headlines ##

When “Headlines collapse sections” is enabled in the Marked Settings, Preview pane, clicking headlines will collapse the section between that headline and the next headline at the same level. Sub-sections within that section are hidden. Optionally, you can limit this behavior to `⌘`-clicking.

Holding down `⌥` when clicking (or `⌘`-clicking) will expand/collapse all of the child sections below the clicked heading. Holding down the `⇧` (Shift) key while clicking will collapse all other sections at the same level, revealing only the clicked section.

Collapsed sections are marked with a yellow highlight to the right of the title, and the cursor will indicate what will happen when the item is clicked.

If an edit is made that needs to be visible, or a table of contents section is clicked that is currently within a collapsed section, the necessary parent sections will be expanded to reveal it.

You can collapse/expand all of the sections in a document at once with the “Collapse all sections” (`⌥`+`⌘`+`←`) and “Expand all sections” (`⌥`+`⌘`+`→`).

See the Document Navigation video on YouTube for more details.

## Custom Processor indicators/toggles ##

When the custom processor and/or preprocessor are enabled, indicator lights appear in the toolbar. These can be used to see whether or not the processor is turned on for the current document (indicator will be highlighted) and clicking them will toggle the use of the custom preprocessor and processor, respectively.

## Scroll To Edit

The “scroll to edit” feature in Marked keeps track of differences between the latest update and the last, trying to find the point where you made your most recent changes. Marked always tracks this, and a small red line appears in the preview to show you the location of the first change detected. In the Marked Settings, Preview pane, you can turn on “Scroll to first edit” and when a preview updates it will gently scroll the view to that location.

With “Scroll to first edit” turned off, you can still press the “e” key at any time in the preview to go to the last stored edit point.

## Autoscroll

See the dedicated Autoscroll page. When using Autoscroll as a teleprompter, special syntax can insert pauses.

## Zoom Overview

See the Zoom Overview page (`Z` in the preview; also works in Word Repetition with `⌃`+`⌘`+`W`).

## Markdown Reference

Select Markdown Reference from the Help menu to display a guide that floats over your other windows. This is handy for those who are still learning Markdown’s syntax. You can open this panel via the keyboard using `⌥`+`⌘`+`M`.

## Global Keyboard Shortcuts

In the Marked Settings, General pane, you can designate a custom keyboard shortcut for activating Marked, and one for raising just the front window to the top without leaving your editor.

#### Next up: Exporting ▶

Support Site | Legal | Privacy