Flexibility is key.
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 inwhich will allow the window to fade when using other applications.
This feature can also be toggled with ⌘⇧F.
Window level defaults
Inyou 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.
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.
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.+?/’).
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. 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. It also means that links and existing highlight elements will break the search string. You can search within those elements, but if a link or highlight starts in the middle of a search string match, it will not be highlighted.
You can toggle the “Whole words,” “Case sensitive,” and “Regex” checkboxes using ^⇧1, 2 and 3, respectively.
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:
This is the equivalent of
Table of Contents
If your document has headers in it, a list button will appear in the toolbar. Clicking this button will expand the Table of Contents, and clicking the title of a header will navigate to that section of the preview. Use “j”/“k” (down/up) to navigate the list from the keyboard, and Enter or “o” to jump to the highlighted header.
Hit the Spacebar to open the type-ahead navigation field. Type any part of the name (uses TextMate-style matching so you can, for example, just type the first letters of each word) and press Tab (⇥) or the Down Arrow (↓) to navigate the filtered list.
Pressing the f key while previewing a document will activate “fast navigation” mode, which opens the Table of Contents with the filter field open and ready for you to type. Just enter any part of a headline’s title and the list will filter down to matching headlines. If the list gets down to a single headline, pressing Return (↩) will jump to that headline automatically. To select from multiple remaining headlines, use the down arrow key or the tab key to leave the filter box, and then j/k or up/down to select the desired headline. “o” or Return will jump to it and close the Table of Contents.
If “Headlines Collapse Sections” is enabled in , holding the Command key while clicking an item in the Table of Contents will collapse or expand that section, revealing parent sections as necessary.
For a list of available shortcuts, see the Keyboard Shortcuts section.
See the Document Navigation video on YouTube for more details.
Customizing the Table of Contents
The Table of Contents may be placed manually in the document using the special syntax
<!--TOC--> anywhere in the text.
You can also set a maximum depth by adding
max# to the TOC tag. For example, to only display the first and second header levels, use
Type “F” in the preview to open the Table of Contents directly to the filter field. You can then start typing the text of any header and filter down to the correct one. If there is only one item shown in the menu after filtering, pressing Return (↩) will go directly to it. To select from multiple results, press Tab (⇥) to exit the filter field and use j/k or ↓/↑ arrows to navigate. Pressing Tab again will return you to the search field.
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.
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.
Set bookmarks on scroll position using ⇧[1–9], and jump back to them using just the number of the bookmark 1–9. You can also use n and p to move through them in their position order. N and P (holding Shift) will move through them in numeric order.
Changing the Style or adjusting the page size will affect the bookmark location. These are meant to be temporary markers when reviewing a document and do not persist between document sessions. They will persist through refreshes and document changes, though.
You can bookmark a headline instead of a scroll position by using Option (⌥) instead of Shift. Typing ⌥[1–9] will add a bookmark for the header closest to the top of the page, or the last one before the top of the page.
Press 0 to expand the bookmarks, showing any applicable header titles and making them easier to click. If the Mini Map (see below) is enabled, this will display at the same time. Press Escape or 0 to shrink the bookmark panel back to its compact state.
Press xx (“x” twice) to clear all bookmarks.
There are additional shortcuts available. Press the h key at any time and a list of shortcuts will be shown. Use ⌘⌥K (or the menu) to open a floating reference of all of Marked’s keyboard shortcuts.
If the Mini Map is enabled in Preview Preferences, you can press 0 to open the Mini Map while viewing your document. It will present your entire document scaled to the height of your screen, and clicking anywhere on the Mini Map will jump to that point in the full-size document. Any bookmarks set will be displayed as horizontal lines on the map, with number and header labels (if applicable).
Holding down the Command (⌘) key while moving the mouse over the Mini Map will enable a magnifier, allowing you to better read the sections you’re jumping to. Holding down the Option (⌥) key and moving the mouse over the Mini Map will scroll as if you’re dragging the scrollbar.
The Mini Map will regenerate when your window changes size, offering you an accurate preview of your document as line breaks and paragraph lengths change.
Press 0 or Escape to close the Mini Map.
Performance note: On very long documents, the preview will freeze momentarily as new Mini Maps are generated. This only happens after a refresh or window size change and only if the map is showing. Marked will automatically detect longer documents and not generate the initial Mini Map until it’s requested (by pressing 0), so if you don’t need it at all, you won’t experience any pauses.
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 Preview preference pane (“Enable link popovers”).
See an overview video on YouTube.
Scroll progress indicator
If enabled, a thin bar across the top of the window will show you your scroll progress in the document. This is especially handy when jumping around the document using the Table of Contents, search or bookmarks on Mountain Lion or higher where you can’t see the scroll bar on the right. The indicator will not show up in printed or exported documents.
When “Headlines collapse sections” is enabled in, 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 Behavior preference panel, 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.
Type z while in the preview to zoom out the text to an overview. This also works in the Word Repetition Visualization (^⌘w) as a way to rapidly view the concentrations of highlighted words in the document. Pressing z again will zoom out at the current scroll location, so it also works as a means for navigating the document.
Select Markdown Reference from themenu 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
Inunder the General tab, 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.