Marked Help

- Getting Started

- Overview

- What's New?

- Marked Basics

- Opening Files

- Previewing

- Interface Features

- Exporting

- Especially for Writers

- Document Statistics

- Scrivener 2.0 Support

- Multi-file Documents

- Fountain (Screenwrite)

- Advanced Features

- Keyboard Shortcuts

- Scroll to Edit

- Toggle Header IDs

- Custom Processor

- Custom Styles

- Workflow Integration

- Marked Special Syntax

- Per-Document Settings

- MathJax

- For Programmers

- Troubleshooting

- Preview Not Updating

- Overall Performance

- Additional Help

- About Markdown

- (Multi)Markdown

- Full Index

Marked Help

The who, what, when, where and why.

For the latest version of this documentation, visit the online version.

What’s Markdown?

Marked works with Markdown and MultiMarkdown, and can convert syntax from several variants for preview (it can also be extended to work with just about any processor you need, including Textile, reStructuredText, Wikitext and more). I assume that–since you’re here–you at least know what these markup languages are. If not, you should start at John Gruber’s Markdown Basics, check out the TUAW Markdown Primer and brush up on extended syntax with the MultiMarkdown User’s Guide. Marked includes a full Markdown syntax guide under the help menu, so you can brush up as you go.

What’s Marked?

Marked is an editor-agnostic MultiMarkdown Preview application which watches a file for changes, updating the preview every time you save. It’s not an “instant” preview, but I’ve found it more efficient as it allows me to concentrate more on writing and less on how my Markdown is rendering. Any time I want to see the results, I just press Command-S and my preview is updated.

Marked works with any file on your local drive, including iCloud documents. Just drag the document from any text editor’s toolbar to Marked and it will render it as an HTML preview and start tracking changes, updating the preview as you write. It can even compile multi-file documents using a basic “include” syntax, or from Scrivener, Leanpub and mmd_merge index formats.

Marked has additional features, including word count and other document statistics, the ability to float above other applications or dim in the background, and it can display your work in a variety of well-crafted styles. It can output to print or PDF, save complete HTML documents and copy HTML source to your clipboard with a keystroke. Marked also has a basic AppleScript dictionary and a command line tool that make it easy to integrate into your workflow.

Example Uses

Marked turns any text editor into a Markdown-enabled editor. Your preview is always available and it updates as you work.

- Do you like writing or blogging in MacVim? Now you have a rapidly-updated Preview window while you work.

- Do you prefer Byword or another full-screen writing application? Float the window above your app and off to the side for a full Markdown writing experience.

- You can also use Marked without an editor. Just drag Markdown files to the icon to preview them, print them and export them to PDF or HTML source code.

- In apps that autosave, you’ll find the preview keeps up with your writing quite well without any help. Use it with any editor… or all of your editors.

- Writing a book? Marked can compile multiple files for a full preview of your work.

top

Marked Help

- Getting Started

- Overview

- What's New?

- Marked Basics

- Opening Files

- Previewing

- Interface Features

- Exporting

- Especially for Writers

- Document Statistics

- Scrivener 2.0 Support

- Multi-file Documents

- Fountain (Screenwrite)

- Advanced Features

- Keyboard Shortcuts

- Scroll to Edit

- Toggle Header IDs

- Custom Processor

- Custom Styles

- Workflow Integration

- Marked Special Syntax

- Per-Document Settings

- MathJax

- For Programmers

- Troubleshooting

- Preview Not Updating

- Overall Performance

- Additional Help

- About Markdown

- (Multi)Markdown

- Full Index

Overview

The who, what, when, where and why.

For the latest version of this documentation, visit the online version.

What’s Markdown?

Marked works with Markdown and MultiMarkdown, and can convert syntax from several variants for preview (it can also be extended to work with just about any processor you need, including Textile, reStructuredText, Wikitext and more). I assume that–since you’re here–you at least know what these markup languages are. If not, you should start at John Gruber’s Markdown Basics, check out the TUAW Markdown Primer and brush up on extended syntax with the MultiMarkdown User’s Guide. Marked includes a full Markdown syntax guide under the help menu, so you can brush up as you go.

What’s Marked?

Marked is an editor-agnostic MultiMarkdown Preview application which watches a file for changes, updating the preview every time you save. It’s not an “instant” preview, but I’ve found it more efficient as it allows me to concentrate more on writing and less on how my Markdown is rendering. Any time I want to see the results, I just press Command-S and my preview is updated.

Marked works with any file on your local drive, including iCloud documents. Just drag the document from any text editor’s toolbar to Marked and it will render it as an HTML preview and start tracking changes, updating the preview as you write. It can even compile multi-file documents using a basic “include” syntax, or from Scrivener, Leanpub and mmd_merge index formats.

Marked has additional features, including word count and other document statistics, the ability to float above other applications or dim in the background, and it can display your work in a variety of well-crafted styles. It can output to print or PDF, save complete HTML documents and copy HTML source to your clipboard with a keystroke. Marked also has a basic AppleScript dictionary and a command line tool that make it easy to integrate into your workflow.

Example Uses

Marked turns any text editor into a Markdown-enabled editor. Your preview is always available and it updates as you work.

- Do you like writing or blogging in MacVim? Now you have a rapidly-updated Preview window while you work.

- Do you prefer Byword or another full-screen writing application? Float the window above your app and off to the side for a full Markdown writing experience.

- You can also use Marked without an editor. Just drag Markdown files to the icon to preview them, print them and export them to PDF or HTML source code.

- In apps that autosave, you’ll find the preview keeps up with your writing quite well without any help. Use it with any editor… or all of your editors.

- Writing a book? Marked can compile multiple files for a full preview of your work.

top

Marked Help

- Getting Started

- Overview

- What's New?

- Marked Basics

- Opening Files

- Previewing

- Interface Features

- Exporting

- Especially for Writers

- Document Statistics

- Scrivener 2.0 Support

- Multi-file Documents

- Fountain (Screenwrite)

- Advanced Features

- Keyboard Shortcuts

- Scroll to Edit

- Toggle Header IDs

- Custom Processor

- Custom Styles

- Workflow Integration

- Marked Special Syntax

- Per-Document Settings

- MathJax

- For Programmers

- Troubleshooting

- Preview Not Updating

- Overall Performance

- Additional Help

- About Markdown

- (Multi)Markdown

- Full Index

What’s New?

The latest stuff

- Marked is now Lion-only for the time being

- Fenced code block support

- Convert alternate extended Markdown syntax (like Markdown Extra) to MMD

- This means you can preview files written for other systems without using a custom processor.

- Handle Leanpub code inclusion syntax

- Merge and preview compiled Leanpub or mmd_merge-style index files

- Syntax for creating books and including external files

- Custom processor now accepts ~ (home dir) and additional arguments

- Printing options

- Syntax for “force page breaks” when printing (<!--BREAK-->)

- “HRs as page breaks” option for printing

- Page break before h1 and/or h2 option

- Style updates

- New style: Amblin by Erik Sagen

- New style: Upstanding Citizen

- Multi-Column style completely rebuilt

- full parity with keyboard navigation and bookmarking available in other styles

- column height adjusts to window height for horizontal-only scrolling

- last column isn’t truncated

- GitHub style updated to match the most recent design changes on GitHub

- Scrivener 2.0+ support

- Drag a Scrivener project (.scriv) to Marked and it will be compiled and previewed

- As with other documents, changes are updated live on save

- When a Scrivener document is in the foreground, Command-E will open it in Scrivener

- Large documents may take longer to refresh

- A cache folder will be created in ~/Library/Application Support/Marked

- Scroll to first edit point on update

- type “e” in preview even when this option is off to scroll to the first difference found since last update

- Automatic syntax highlighting option for code blocks in preview, multiple styles available

- Popover on external links

- Copy URL/Validate link/Open in default browser

- Table of contents is fully keyboard navigable

- Up/Down/j/k to navigate visible menu items

- pressing space will focus a type-ahead field with QuickSilver-style matching to filter the list

- Escape to dismiss TOC/reset the search field

- Set per-document default styles using a metadata header “Marked Style:”

- reference styles by title, full path or CSS filename (valid custom styles work)

- Syntax highlighting/better display for source view (âŒ˜U)

- CLI for running Marked from the command line (mark, installation instructions under “Help”)

- Github-style line break option (preserves line breaks in paragraphs)

- Option to disable automatic header ID generation

- Revamped interface, (Note: Source/Preview toggle is now in the title bar)

- More verbose link and footnote previews on hover

- Markdown reference guide (under “Help”) is a resizable, floating panel (stays on top when application is in foreground)

- Markdown reference includes basic MultiMarkdown syntax

top

Marked Help

- Getting Started

- Overview

- What's New?

- Marked Basics

- Opening Files

- Previewing

- Interface Features

- Exporting

- Especially for Writers

- Document Statistics

- Scrivener 2.0 Support

- Multi-file Documents

- Fountain (Screenwrite)

- Advanced Features

- Keyboard Shortcuts

- Scroll to Edit

- Toggle Header IDs

- Custom Processor

- Custom Styles

- Workflow Integration

- Marked Special Syntax

- Per-Document Settings

- MathJax

- For Programmers

- Troubleshooting

- Preview Not Updating

- Overall Performance

- Additional Help

- About Markdown

- (Multi)Markdown

- Full Index

Opening Files

Marked gives you options.

Drag to Dock Icon

The easiest way to use Marked on a file you’re already editing is to drag the document icon from the toolbar of your editor or from Finder to the Marked icon in your Dock. Marked will immediately start tracking any Markdown file (or text file) dropped on it. You can also drag files directly from the Finder.

Using the Menu

You can, of course, open Markdown files directly using the File->Open… menu option. Marked works fine without a text editor, too. You can preview and convert your Markdown with just a click.

Open Recent

Marked keeps track of recent documents, too. The File->Open Recent menu option will show you the files you’ve had open and let you jump back to them. You can quickly re-open the last file you were viewing with Command-Shift-R. There are a lot of other keyboard shortcuts, too. If you care to learn them, you can find a chart by clicking the Special Features link in the sidebar.

On the Command Line

You can install the Marked command line utility from the Marked menu. Once you’ve done that, you’ll be able to open your files in Marked using mark filename.md. Future versions of Marked will have additional command line features.

top

Marked Help

- Getting Started

- Overview

- What's New?

- Marked Basics

- Opening Files

- Previewing

- Interface Features

- Exporting

- Especially for Writers

- Document Statistics

- Scrivener 2.0 Support

- Multi-file Documents

- Fountain (Screenwrite)

- Advanced Features

- Keyboard Shortcuts

- Scroll to Edit

- Toggle Header IDs

- Custom Processor

- Custom Styles

- Workflow Integration

- Marked Special Syntax

- Per-Document Settings

- MathJax

- For Programmers

- Troubleshooting

- Preview Not Updating

- Overall Performance

- Additional Help

- About Markdown

- (Multi)Markdown

- Full Index

Previewing

Changing the way you see things.

Choosing a style

You can set a default style for new documents in the Window Preferences. If you have the style menu in the toolbar enabled (Window Preferences), you can adjust the style on a per-document basis right from the Preview window. Your style selection will be remembered and will be the first choice for export and print options.

Custom styles added in the Style preferences will be available in both menus.

Text Zoom

You can change the text size using the Zoom menu under Preview in the menubar or in the gear menu on the document window. Marked will remember any changes you make for next time (and every time).

High Contrast

If you prefer light text on a dark background, Marked has you covered. In the Style preference panel, you can invert any of the existing schemes.

top

Marked Help

- Getting Started

- Overview

- What's New?

- Marked Basics

- Opening Files

- Previewing

- Interface Features

- Exporting

- Especially for Writers

- Document Statistics

- Scrivener 2.0 Support

- Multi-file Documents

- Fountain (Screenwrite)

- Advanced Features

- Keyboard Shortcuts

- Scroll to Edit

- Toggle Header IDs

- Custom Processor

- Custom Styles

- Workflow Integration

- Marked Special Syntax

- Per-Document Settings

- MathJax

- For Programmers

- Troubleshooting

- Preview Not Updating

- Overall Performance

- Additional Help

- About Markdown

- (Multi)Markdown

- Full Index

Interface Features

Flexibility is key.

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 Preferences which will allow the window to fade when using other applications.

This feature can also be toggled with Command-Shift-F.

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 Command-U.

Search

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

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.

Keyboard Navigation

The preview window can be navigated quickly using keyboard shortcuts. Set bookmarks on scroll position using Shift-[1-9], and jump back to them using just the number of the bookmark [1-9]. Changing the current 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.

There are additional shortcuts available. Press the “h” key at any time and a list of shortcuts will be shown.

Full-Screen

Full-screen mode can be toggled from the Preview menu, by clicking the double arrow symbol in the upper right corner of the window or by typing Command-Control-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 Behavior preference pane.

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.

top

Marked Help

- Getting Started

- Overview

- What's New?

- Marked Basics

- Opening Files

- Previewing

- Interface Features

- Exporting

- Especially for Writers

- Document Statistics

- Scrivener 2.0 Support

- Multi-file Documents

- Fountain (Screenwrite)

- Advanced Features

- Keyboard Shortcuts

- Scroll to Edit

- Toggle Header IDs

- Custom Processor

- Custom Styles

- Workflow Integration

- Marked Special Syntax

- Per-Document Settings

- MathJax

- For Programmers

- Troubleshooting

- Preview Not Updating

- Overall Performance

- Additional Help

- About Markdown

- (Multi)Markdown

- Full Index

Exporting

Turning your Markdown into a finished document.

Copy HTML

Use the Copy HTML feature to put the HTML source code for your preview into your clipboard without any hassle. You can select it from the gear menu, or just hit Command-Shift-C. The copied HTML will be a snippet ready for insertion into a blog, forum or existing HTML document.

You don’t need to be in the source view to copy. With the preview focused (click on it), just type Command-Shift-C and you’ll see a popup message letting you know that the source is in your clipboard.

Save HTML

The Save HTML command-accessible from the gear menu or by simply typing Command-S-will allow you to save a full document ready for sharing or publishing.

You can optionally include any of Marked’s styles (or one of your custom styles) in your export, giving you a ready-to-go document with necessary formatting already embedded.

Embedding styles with MultiMarkdown comes with a small caveat: if you have any metadata in the top of your document, MultiMarkdown 3 will render a complete document on its own and embedding styles will not be an option. You can, however, use the HTML Header metadata to include your own stylesheet. Checking Strip MMD3 Metadata in Behavior preferences will circumvent this issue, but your metadata will not be included in the final output.

Print/PDF

Print/PDF Preview (Command-P) will bring up a standard print dialog. Each preview style in Marked has its own accompanying print styles which remove backgrounds, modify type sizes and provide borders. The preview will print based on the currently-selected style.

Prominent on the print dialog box are the PDF and Preview buttons. PDF will give you a variety of options for exporting to PDF (based on your available applications) and Preview will export a PDF version directly to Preview.app where you can save or email it.

Printing to PDF using this method will include pagination. When printing to paper or PDF, page breaks may be inserted manually by using the <!--BREAK--> syntax or by setting preferences under Printing to use level one and/or level two headers as section dividers.

There is also a preference for turning horizontal rules (<hr>) into page breaks when printing. Doing so will replace the line created by the tag with a page break, removing it from the final output. The preview is unaffected by this setting.

Save PDF

This option saves your Preview directly to a PDF file on your drive. Your document will be rendered in its entirety, without page breaks. To include pagination in your output, use the Print/PDF option.

Copy Rich Text

Marked can export RTF (Rich Text Format) data directly to your clipboard. Just choose the Copy Rich Text command from the gear menu.

Save RTF

Marked can also save your file as an RTF (Rich Text Format) file with the Save RTF command.

top

Marked Help

- Getting Started

- Overview

- What's New?

- Marked Basics

- Opening Files

- Previewing

- Interface Features

- Exporting

- Especially for Writers

- Document Statistics

- Scrivener 2.0 Support

- Multi-file Documents

- Fountain (Screenwrite)

- Advanced Features

- Keyboard Shortcuts

- Scroll to Edit

- Toggle Header IDs

- Custom Processor

- Custom Styles

- Workflow Integration

- Marked Special Syntax

- Per-Document Settings

- MathJax

- For Programmers

- Troubleshooting

- Preview Not Updating

- Overall Performance

- Additional Help

- About Markdown

- (Multi)Markdown

- Full Index

Document Statistics

Keep track as you write.

Word Count and Document Statistics

Word count is located in the bottom status bar and can be enabled and disabled from Preferences. You can view further statistics in the preview or source window from the gear menu, clicking the word count or by typing Command-Option-S.

Word Count for Selection

When you select text in the preview, a small box will pop up by the mouse to show the word/line/character count for just the selected text. This is dismissed simply by moving the mouse away from the popup.

Readability Statistics

Additional statistics from Flesch/Kincaid and the Fog Index are available with Command-Shift-Option-S. This feature is still experimental and the results are not guaranteed to be 100% accurate.

Visualize Word Repetition

Selecting Visualize Word Repetition from the gear menu–or pressing Command-Control-W–will open up a special overlay for displaying words that are repeated in your document. Repeated words are displayed in bold, and hovering over a bolded word will highlight the matching words throughout the document. Clicking a bolded word will darken the background and “stick” the highlighting for further review.

Scope

The scope of the repetition check can be changed at the top of the preview and set to Document or Paragraph. Document mode is default; selecting Paragraph only counts repetition within each block of text. Repeats will still be highlighted through the entire document, but only counted if a word appears more than once within a paragraph.

Exiting Word Repetition mode

You can close the word repetition view using the Close button at the top or by clicking in the gutter to either side of the view.

top

Marked Help

- Getting Started

- Overview

- What's New?

- Marked Basics

- Opening Files

- Previewing

- Interface Features

- Exporting

- Especially for Writers

- Document Statistics

- Scrivener 2.0 Support

- Multi-file Documents

- Fountain (Screenwrite)

- Advanced Features

- Keyboard Shortcuts

- Scroll to Edit

- Toggle Header IDs

- Custom Processor

- Custom Styles

- Workflow Integration

- Marked Special Syntax

- Per-Document Settings

- MathJax

- For Programmers

- Troubleshooting

- Preview Not Updating

- Overall Performance

- Additional Help

- About Markdown

- (Multi)Markdown

- Full Index

Scrivener 2.0 Support

Use your two favorite writing tools together.

Scrivener 2.0 Basics

Drag a Scrivener project (.scriv) to Marked and it will be compiled and previewed. If you choose the option to open .scriv files in Scrivener (above), Marked will also launch Scrivener when you drag the file to Marked.

As with other documents, changes to Scrivener files are updated live on save. Also, when a Scrivener document is in the foreground in Marked, Command-E will open it in Scrivener for you.

Markdown Headers

Marked can also create hierarchical Markdown headers for you based on your Scrivener file’s pages. To enable this, just check the option shown above.

Additional features

In addition to the basic compiling and preview features, Marked also supports some Scrivener-specific conventions. First, in your Scrivener document, you can use “Preserve Formatting” inline or on a block of standalone text and it will be converted to code blocks in the preview.

Marked also reads inline footnotes from Scrivener. If you enter a footnote within or at the end of a paragraph, it will be converted to a MultiMarkdown footnote in the preview.

Security Note

A cache folder will be created in ~/Library/Application Support/Marked when you open your .scriv file in Marked. This is not a protected folder, so if your original document is on an encrypted disk or otherwise protected, note that its contents will be unencrypted in the cache. For limited protection, you can ensure this cache doesnâ€™t show up in Spotlight by adding ~/Library/Application Support/Marked to your privacy settings in Spotlight.

top

Marked Help

- Getting Started

- Overview

- What's New?

- Marked Basics

- Opening Files

- Previewing

- Interface Features

- Exporting

- Especially for Writers

- Document Statistics

- Scrivener 2.0 Support

- Multi-file Documents

- Fountain (Screenwrite)

- Advanced Features

- Keyboard Shortcuts

- Scroll to Edit

- Toggle Header IDs

- Custom Processor

- Custom Styles

- Workflow Integration

- Marked Special Syntax

- Per-Document Settings

- MathJax

- For Programmers

- Troubleshooting

- Preview Not Updating

- Overall Performance

- Additional Help

- About Markdown

- (Multi)Markdown

- Full Index

Multi-file Documents

You can include external files in a single preview document by using the syntax <<[path/file] at the beginning of a line. The line should have blank lines above and below it, and the path is assumed to be relative to the main document unless it begins with a slash (/) or a tilde (~). Slash (root directory) and tilde (home directory) may be used to define absolute paths to files. No path is needed if the external files are in the same folder as the main document, just put the filename (case sensitive and including extension) in the square brackets.

Using this feature you can build large documents/books using multiple files (e.g. a file for each chapter) and then specify the document order in a single index file. It doesn’t matter how any of the files are named or how the folders are organized; the file you open in Marked will be considered the index and the files listed inside it will be included. An example of an index file for a three-part document:

Folder structure:

Index.md:

# Document title

## Section 1

<<[sections/section1.md]

## Section 2

<<[sections/section2.md]

## Section 3

<<[sections/section3.md]

Opening Index.md in Marked will display its contents with all three included files expanded inside. All included files will be watched for changes. Unlike the open document in Marked, included file tracking depends on Spotlight to obtain updates and must exist in a Spotlight-indexed folder on your disk.

You can also include code snippets and raw html or text using variations of this syntax.

Note: the more files included in a document, the slower the overall compile time of the preview will be. Marked tries to optimize and cache the process, but expect some rendering delays as your document size increases.

Book Formats

Marked also supports index files in formats like Leanpub and mmd_merge (MultiMarkdown). These require that the first line be “frontmatter:” (Leanpub format) or “#merge” (special Marked trigger for mmd_merge, treated as a comment and ignored by other processors). Included files will be watched for changes and the result is a complete preview of your compiled document, just like the “Index.md” example above.

top

Marked Help

- Getting Started

- Overview

- What's New?

- Marked Basics

- Opening Files

- Previewing

- Interface Features

- Exporting

- Especially for Writers

- Document Statistics

- Scrivener 2.0 Support

- Multi-file Documents

- Fountain (Screenwrite)

- Advanced Features

- Keyboard Shortcuts

- Scroll to Edit

- Toggle Header IDs

- Custom Processor

- Custom Styles

- Workflow Integration

- Marked Special Syntax

- Per-Document Settings

- MathJax

- For Programmers

- Troubleshooting

- Preview Not Updating

- Overall Performance

- Additional Help

- About Markdown

- (Multi)Markdown

- Full Index

Fountain (Screenwrite)

Fountain is a specialized text markup language that is designed for writing screenplays. Screenwriters who write using Fountain’s syntax can use Marked to preview their work.

Install Fountain

To use Marked with Fountain, you’ll need to first download and install Fountain’s files. You can find complete instructions on the candler blog

Set up a custom processor

After you’ve installed Fountain, select Behavior in Marked’s Preferences, check the box to use a Custom Markdown Processor, and add the path to your screenplain_marked.sh file.

Add Fountain’s custom style

To correctly preview your screenplays, select Style in Marked’s Preferences, click the + sign beneath the Custom CSS box, and find your copy of Fountain.css.

top

Marked Help

- Getting Started

- Overview

- What's New?

- Marked Basics

- Opening Files

- Previewing

- Interface Features

- Exporting

- Especially for Writers

- Document Statistics

- Scrivener 2.0 Support

- Multi-file Documents

- Fountain (Screenwrite)

- Advanced Features

- Keyboard Shortcuts

- Scroll to Edit

- Toggle Header IDs

- Custom Processor

- Custom Styles

- Workflow Integration

- Marked Special Syntax

- Per-Document Settings

- MathJax

- For Programmers

- Troubleshooting

- Preview Not Updating

- Overall Performance

- Additional Help

- About Markdown

- (Multi)Markdown

- Full Index

Keyboard Shortcuts

A floating panel with a shortcut cheat sheet is available from the Help menu, or by pressing ⌘⇧K.

Keyboard Shortcuts

Function

Shortcut

Preferences

⌘,

Open

⌘O

Re-open Last

⌘⇧R

Close

⌘W

Print Preview Window

⌘P

Save HTML

⌘S

Save PDF

⌘⇧P

Save RTF

⌘⇧S

Copy

⌘C

Copy HTML Source to clipboard

⌘⇧C

Toggle Source View

⌘U

Toggle Table of Contents

⌘T

Reload Preview

⌘R

Select Style

⌘# (1-9)

Gear Menu

⌘/

Zoom In

⌘⇧=

Zoom Out

⌘⇧-

Reset Zoom

⌘⇧0

Minimize

⌘M

Keep on Top

⌘⇧F

Visualize Word Repetition

^⌘W

Document Statistics

⌘⌥S

Readability Statistics

⌘⇧⌥S

Toggle Custom Processor

⌘⌥C

Search

⌘F

Highlight next match

⌘G

Highlight previous match

⌘⇧G

Press “?” at any time to view the following shortcuts in the Preview window.

Preview Navigation Shortcuts

Function

Shortcut

Jump to Top

t or gg

Jump to Bottom

b or G

Set a Bookmark

⇧-[1-9]

Scroll to Bookmark

[1-9]

Next/Prev Bookmark Numerically

N/P

Next/Prev Bookmark in Page Order

n/p

Scroll Down/Up

j/k

Scroll Up/Down Faster

J/K

Navigate All Headers

,/.

Navigate H1/H2 Headers

</>

Jump to Most Recent Edit Point

e

Close an Open Overlay

esc

Show/Hide Help Hud

h

When the Table of Contents is open, you can navigate via keyboard.

Table of Contents Navigation

Function

Shortcut

Open TOC

âŒ˜T

Select first/next header

j/Up Arrow

Select previous header

k/Down Arrow

Scroll to selection

o

Open TOC quick-search

Space

Select first search result

Down Arrow/Tab

Clear search/Dismiss TOC

Esc

top

Marked Help

- Getting Started

- Overview

- What's New?

- Marked Basics

- Opening Files

- Previewing

- Interface Features

- Exporting

- Especially for Writers

- Document Statistics

- Scrivener 2.0 Support

- Multi-file Documents

- Fountain (Screenwrite)

- Advanced Features

- Keyboard Shortcuts

- Scroll to Edit

- Toggle Header IDs

- Custom Processor

- Custom Styles

- Workflow Integration

- Marked Special Syntax

- Per-Document Settings

- MathJax

- For Programmers

- Troubleshooting

- Preview Not Updating

- Overall Performance

- Additional Help

- About Markdown

- (Multi)Markdown

- Full Index

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.

Notes on “Scroll to Edit”

This is a feature that is great when it works, but there are a lot of complications. Especially the first few times the document updates, there may be some jerkiness in the scroll. If your changes are all inside of one very large element (an excessively long paragraph, for example), it will only be able to get close with the marker. Similarly, if you add one or two words to the end of the document, the change marker will be positioned in the element above until there is enough content to anchor in the new element.

top

Marked Help

- Getting Started

- Overview

- What's New?

- Marked Basics

- Opening Files

- Previewing

- Interface Features

- Exporting

- Especially for Writers

- Document Statistics

- Scrivener 2.0 Support

- Multi-file Documents

- Fountain (Screenwrite)

- Advanced Features

- Keyboard Shortcuts

- Scroll to Edit

- Toggle Header IDs

- Custom Processor

- Custom Styles

- Workflow Integration

- Marked Special Syntax

- Per-Document Settings

- MathJax

- For Programmers

- Troubleshooting

- Preview Not Updating

- Overall Performance

- Additional Help

- About Markdown

- (Multi)Markdown

- Full Index

Toggle Header IDs

Marked includes an option to disable automatic header ID generation. You can find this option on the Behavior pane in Preferences.

top

Marked Help

- Getting Started

- Overview

- What's New?

- Marked Basics

- Opening Files

- Previewing

- Interface Features

- Exporting

- Especially for Writers

- Document Statistics

- Scrivener 2.0 Support

- Multi-file Documents

- Fountain (Screenwrite)

- Advanced Features

- Keyboard Shortcuts

- Scroll to Edit

- Toggle Header IDs

- Custom Processor

- Custom Styles

- Workflow Integration

- Marked Special Syntax

- Per-Document Settings

- MathJax

- For Programmers

- Troubleshooting

- Preview Not Updating

- Overall Performance

- Additional Help

- About Markdown

- (Multi)Markdown

- Full Index

Custom Processor

Marked gives you full control.

Using a custom processor

You can specify a custom Markdown processor in the Behavior section of the Preferences. Enter a UNIX path to an executable or script which can take input on STDIN and return output on STDOUT and it will be used for Preview, Source, Print and Save operations. This can, for example, allow Maruku or Kramdown to be used instead of MultiMarkdown, or even incorporate Textile and other markup languages into Marked.

Marked sets an environment variable for the current working directory (PWD) to the location of the file currently being previewed. You can use this to change the working directory of a script and include files with relative paths to the current document. As an example, in Ruby you can use:

Dir.chdir(ENV['PWD'])

When enabled, the custom processor can be turned on and off for individual documents using Command-Option-C.

Environment variables

Marked runs the custom processor in its own shell, meaning standard environment variables are not automatically passed. You can use Marked’s environment variables to augment your own in your scripts. Marked makes the following variables available for use in your shell scripts:

PWD

The current location (base directory) of your primary working file (the folder of the working text, Scrivener or index file).

PATH

Marked sets a path which includes default executable folders and appends the directory in the PWD above. The defaults are: /Developer/usr/bin:/usr/bin:/bin:/usr/sbin:/sbin:/usr/local/bin. You can add your own by setting the PATH variable as needed and appending or overwriting Marked’s path (e.g. PATH=/usr/local/yourfolder:$PATH).

HOME

The home directory of the current user. Python and other scripts which rely on the HOME variable being set will pick this up automatically, but it’s available for other uses in your scripts.

MARKED_EXT

The extension of the primary file being processed. This variable allows you to script different processes based on the type of file being viewed. For example, if $MARKED_EXT == “md” run your preferred Markdown processor, but if $MARKED_EXT == “textile” run a Textile processor.

MARKED_PATH

This is the full UNIX path to the main file open in Marked when the processor is run.

MARKED_INCLUDES

A quoted, comma-separated list of the files Marked has included in the text being passed using the various include syntaxes.

Using Textile as your markup language

A few people have asked how to get Textile working in Marked. You need to have a Textile converter available from the command line. There are a few options, including Pandoc, but the two easiest I’ve found are RedCloth for Ruby and Textile for Perl (requires that the Developer Tools be installed). Install one or the other:

1. Install Textile from https://github.com/bradchoate/text-textile OR sudo gem install RedCloth in Terminal.

2. Set your preferences like above for the Perl version. Use /usr/bin/redcloth for RedCloth.

Note: your install paths may differ. You can determine the correct path using which textile or which redcloth in the Terminal.

Now Marked is a Textile previewer for you!

top

Marked Help

- Getting Started

- Overview

- What's New?

- Marked Basics

- Opening Files

- Previewing

- Interface Features

- Exporting

- Especially for Writers

- Document Statistics

- Scrivener 2.0 Support

- Multi-file Documents

- Fountain (Screenwrite)

- Advanced Features

- Keyboard Shortcuts

- Scroll to Edit

- Toggle Header IDs

- Custom Processor

- Custom Styles

- Workflow Integration

- Marked Special Syntax

- Per-Document Settings

- MathJax

- For Programmers

- Troubleshooting

- Preview Not Updating

- Overall Performance

- Additional Help

- About Markdown

- (Multi)Markdown

- Full Index

Custom Styles

View your documents your way.

Using custom styles

Add custom stylesheets to Marked using the Styles pane in Marked Preferences. Styles will be named based on the base filename of the CSS file added. New styles will be added to the dropdown menus in Window preferences and on each window. Store your custom CSS files in a safe place on your drive. “Bad Things” may happen if you remove or rename a CSS file while it’s active in Marked. Close windows and remove the style from Preferences when deleting or renaming a CSS file used by Marked.

Watching CSS changes

You can check a box below the Custom Styles table to have Marked watch the active CSS file in addition to the Markdown file you’re editing. When changes are detected on either file, the preview will update. This is useful for editing custom styles without constantly refreshing and can also be used for simple web development tasks. You can open straight HTML documents and assign a custom stylesheet, and if you set your custom processor to /usr/bin/php, you can also have PHP files rendered in the preview.

Writing custom CSS

If you’re familiar with CSS, you can create your own style sheets for use in Marked. This knowledge base article has detailed instructions for writing and sharing your creations.

top

Marked Help

- Getting Started

- Overview

- What's New?

- Marked Basics

- Opening Files

- Previewing

- Interface Features

- Exporting

- Especially for Writers

- Document Statistics

- Scrivener 2.0 Support

- Multi-file Documents

- Fountain (Screenwrite)

- Advanced Features

- Keyboard Shortcuts

- Scroll to Edit

- Toggle Header IDs

- Custom Processor

- Custom Styles

- Workflow Integration

- Marked Special Syntax

- Per-Document Settings

- MathJax

- For Programmers

- Troubleshooting

- Preview Not Updating

- Overall Performance

- Additional Help

- About Markdown

- (Multi)Markdown

- Full Index

Workflow Integration

AppleScript

Marked has a basic AppleScript dictionary, and allows you to get the currently open file from multiple windows, as well as open files from scripts. This allows some workflow integration if you know a little bit of AppleScript. You can have any application which can trigger an AppleScript open a document in Marked, or have it pull the currently-previewed document in Marked in for editing.

The AppleScript integration also allows applications such as Tags.app to function directly within Marked.

Marked Bonus Pack

The Marked Bonus Pack is a collection of scripts, commands and services. Some work with multiple editors, some are specific to certain editors. The Services will generally work with any editor that has the necessary capabilities. The rest are organized in folders based on the application they work with.

You can download the Bonus Pack and find instructions for installing and using it in this knowledge base article.

top

Marked Help

- Getting Started

- Overview

- What's New?

- Marked Basics

- Opening Files

- Previewing

- Interface Features

- Exporting

- Especially for Writers

- Document Statistics

- Scrivener 2.0 Support

- Multi-file Documents

- Fountain (Screenwrite)

- Advanced Features

- Keyboard Shortcuts

- Scroll to Edit

- Toggle Header IDs

- Custom Processor

- Custom Styles

- Workflow Integration

- Marked Special Syntax

- Per-Document Settings

- MathJax

- For Programmers

- Troubleshooting

- Preview Not Updating

- Overall Performance

- Additional Help

- About Markdown

- (Multi)Markdown

- Full Index

Marked Special Syntax

Page breaks

You can force page breaks in a document printed from the preview by inserting an HTML-style comment in your document:

<!--BREAK-->

Place that tag at the beginning of a line at any point in your document where you’d like to force the page to end and begin printing on the next page. These comments won’t show up in exported HTML, and won’t affect your preview or document statistics. Marked also recognizes Leanpub pagebreak format, so current documents are already compatible.

Note that in the Printing section of Preferences you can also tell Marked to automatically substitute page breaks for horizontal rules (---) or use level 1 and/or 2 headers as section dividers.

File includes

The contents of additional files can be inserted by using the syntax:

<<[folder/filename]

The path to the file can be relative to the index file or absolute. Includes can be nested; you can use this same syntax inside of an included file. If you’re using relative paths, includes in nested files should be relative to that file. However, MultiMarkdown will process everything based on the location of the first file opened, so all image paths or other embeds should be relative to the first parent file, even when they exist in child documents.

See “Multi-File Documents” for more information.

Including code

Marked can include external files as code using a syntax similar to file includes above:

<<(folder/filename)

Note the parenthesis instead of square brackets. For compatibility with Leanpub syntax, Marked will also recognize a preceding set of square brackets containing a title, but at the current time nothing is done with it in Marked:

<<[Code title](folder/filename)

The contents of the specified file will be inserted within a pre>code block in your document and will be available for automatic syntax highlighting if it’s enabled. Code blocks can not be nested and will not be processed with MultiMarkdown. Custom processors will still be run over the pre>code block created.

Including unprocessed text or html

Note: This feature is for advanced users.

If you want to include raw HTML or other text that should not be processed by MultiMarkdown (or your custom processor), you can use curly brackets ({}) to include a file after processing the rest of the document:

<<{folder/raw_file.html}

No include syntax will be recognized within these files (no nesting) and the raw contents of the file will be inserted in the final HTML output. This is great for inserting HTML without bogging down the text processor or having things converted/escaped when you don’t want them to be, but be careful as there are few safeguards to ensure formatting of the document is preserved around what you insert.

top

Marked Help

- Getting Started

- Overview

- What's New?

- Marked Basics

- Opening Files

- Previewing

- Interface Features

- Exporting

- Especially for Writers

- Document Statistics

- Scrivener 2.0 Support

- Multi-file Documents

- Fountain (Screenwrite)

- Advanced Features

- Keyboard Shortcuts

- Scroll to Edit

- Toggle Header IDs

- Custom Processor

- Custom Styles

- Workflow Integration

- Marked Special Syntax

- Per-Document Settings

- MathJax

- For Programmers

- Troubleshooting

- Preview Not Updating

- Overall Performance

- Additional Help

- About Markdown

- (Multi)Markdown

- Full Index

Per-Document Settings

Marked will allow certain parameters from a document to be set in MultiMarkdown metadata format (detailed below). You can use these to define characteristics and styles that only affect the current document.

Most MultiMarkdown headers are ignored by the preview, but the following are allowed and affect rendering. You can include other metadata to be rendered in the final output, Marked will just ignore keys not listed below. If you save as HTML and do not include a template, Marked will render all metadata keys as expected.

Metadata format

Metadata is entered at the very top of the Markdown file or immediately following any Yaml headers. They consist of a key, followed by a colon, optional spaces or tabs and the value:

Example metadata: example key

Multiple metadata entries should be on their own lines, but without any line breaks between them. The last metadata entry needs to be followed by a blank line before the start of the document text.

First: this is the first metadata entry
Second: this is the second entry
Third: the last metadata entry

# The beginning of the document text

Marked metadata keys

Per-document styles

The “Marked Style:” key will set a preview style for the document. The value can be the name of a default style or a name or path for any Custom Styles you have defined in the preferences. If this key is found and matches a style that Marked knows about, that style will be used for the preview every time the document containing it is loaded.

Example

Marked Style: Upstanding Citizen

Quotes language

By default, Marked uses English-style quotation marks. You can modify this on a per-document basis with the “Quotes Language:” key. Available languages are:

- dutchâ€¨* englishâ€¨* frenchâ€¨* germanâ€¨* germanguillemets

- swedish

Example

Quotes Language: french

Creates French-language Â«quotation marks.Â»

Base header level

You can set the header level that Marked starts counting from with the “Base Header Level:” key. This should be a number 1-6, and will modify the way that “#” headers are rendered. If you set the header level to 3, then what would normally be a first-level header (h1) is rendered as a third-level header (h3), and subsequent headers in the hierarchy are shifted up by 2.

Example

Base Header Level: 3

# This headline will render as an h3

## This headline will be an h4

Renders as:

<h3>This headline will render as an h3</h3>

<h4>This headline will be an h4</h4>

Inserting JavaScript

This specifies data that is included in the <head> tag of the document. Marked ignores most values for this key, except in full-document output, but will respect scripts included in this manner. Script tags defined here will not be in the header, however, they’ll be appended before the closing </body> tag. jQuery is already loaded, and you can take advantage of that in any scripts you inject.

Example

XHTML Header: <script>(function($){$('#wrapper').fadeOut();})(jQuery);</script>

-or-

XHTML Header: <script src="myfancyscript.js"></script>

top

Marked Help

- Getting Started

- Overview

- What's New?

- Marked Basics

- Opening Files

- Previewing

- Interface Features

- Exporting

- Especially for Writers

- Document Statistics

- Scrivener 2.0 Support

- Multi-file Documents

- Fountain (Screenwrite)

- Advanced Features

- Keyboard Shortcuts

- Scroll to Edit

- Toggle Header IDs

- Custom Processor

- Custom Styles

- Workflow Integration

- Marked Special Syntax

- Per-Document Settings

- MathJax

- For Programmers

- Troubleshooting

- Preview Not Updating

- Overall Performance

- Additional Help

- About Markdown

- (Multi)Markdown

- Full Index

MathJax

Numbers matter just as much as words.

Preview formulas with MathJax

By turning on MathJax in the Behavior preferences, when you have a network connection to the Internet, the necessary scripts will be included in the preview. Then MultiMarkdown math syntax can be used in your Markdown document and the results will be displayed.

top

Marked Help

- Getting Started

- Overview

- What's New?

- Marked Basics

- Opening Files

- Previewing

- Interface Features

- Exporting

- Especially for Writers

- Document Statistics

- Scrivener 2.0 Support

- Multi-file Documents

- Fountain (Screenwrite)

- Advanced Features

- Keyboard Shortcuts

- Scroll to Edit

- Toggle Header IDs

- Custom Processor

- Custom Styles

- Workflow Integration

- Marked Special Syntax

- Per-Document Settings

- MathJax

- For Programmers

- Troubleshooting

- Preview Not Updating

- Overall Performance

- Additional Help

- About Markdown

- (Multi)Markdown

- Full Index

For Programmers

Syntax Highlighting

Syntax highlighting can be enabled in the Style preferences. It will recognize code blocks, detect the language and render color-coded output in the preview. There are multiple themes available, selected by the dropdown below the option in preferences. The selected theme will apply to all documents.

Marked uses highlight.js to provide consistent color coding for all types of embedded code, including standard Markdown syntaxes that don’t allow language to be specified. Highlight.js autodetects quite well. There are some minor rendering differences between it and colorizers such as Pygments (GitHub style), but the output is quite similar. Using the github.css theme on Ruby code, for example, renders almost the exact output you’d see on GitHub[1].

Syntax highlighting will show up in the preview and in print and PDF export. If enabled in preferences and the theme is included when exporting HTML, the highlight.js library used by Marked will be embedded in the HTML output, allowing your exported HTML to appear as it does in Marked.

Github-style line breaks

Marked can preserve line breaks in your paragraphs. Just select Behavior in Preferences and check the box to retain line breaks in paragraphs.

Fenced code blocks

If enabled in the Behavior preferences, fenced code blocks in your document will be rendered. Fenced code blocks are delimited by three or more tildes (~) or backticks (`). You can use more than three, but the beginning and ending delimiters must have exactly the same number of characters.

~~~
Some code to be rendered as a pre/code block
~~~

Languages may be specified using the language title (or short title) after the delimiter in the first line, or in curly brackets (with or without a leading period) after the last delimeter. For example:

~~~~~ruby
some ruby code
~~~~~

Or:

`````
some Java code
`````{.java}

The built in syntax highlighting will recognize 41 different language specifiers. If there is no language specified, it will detect it automatically, so it’s not required for the preview. The language string given will be output in the final html as a class on the <code> tag.

See the section on Marked Special Syntax to learn how to include external code files in your document.

1. The GitHub stylesheet provides backup styles for blocks actually rendered with Pygments. If the <pre> tag is inside a div with the class “highlight”, it will display using the standard GitHub styling, not Marked’s. You can render the code externally and paste HTML, or use pygmentize to render it to html files and include them with the <<(source.html) syntax.↩

top

Marked Help

- Getting Started

- Overview

- What's New?

- Marked Basics

- Opening Files

- Previewing

- Interface Features

- Exporting

- Especially for Writers

- Document Statistics

- Scrivener 2.0 Support

- Multi-file Documents

- Fountain (Screenwrite)

- Advanced Features

- Keyboard Shortcuts

- Scroll to Edit

- Toggle Header IDs

- Custom Processor

- Custom Styles

- Workflow Integration

- Marked Special Syntax

- Per-Document Settings

- MathJax

- For Programmers

- Troubleshooting

- Preview Not Updating

- Overall Performance

- Additional Help

- About Markdown

- (Multi)Markdown

- Full Index

Preview Not Updating

Previews not updating as expected?

Time Machine

There have been some issues reported regarding slow (or non-existent) updates during a Time Machine run. The update capabilities of Marked may be impaired if Time Machine is using the portion of the drive where the file exists at the time. This will usually remedy itself when Time Machine finishes its run.

If you have trouble with Marked not responding to updates after Time Machine has completed its run, or at a time when Time Machine isn’t running at all, please file a ticket on the support site and we’ll troubleshoot this with you.

top

Marked Help

- Getting Started

- Overview

- What's New?

- Marked Basics

- Opening Files

- Previewing

- Interface Features

- Exporting

- Especially for Writers

- Document Statistics

- Scrivener 2.0 Support

- Multi-file Documents

- Fountain (Screenwrite)

- Advanced Features

- Keyboard Shortcuts

- Scroll to Edit

- Toggle Header IDs

- Custom Processor

- Custom Styles

- Workflow Integration

- Marked Special Syntax

- Per-Document Settings

- MathJax

- For Programmers

- Troubleshooting

- Preview Not Updating

- Overall Performance

- Additional Help

- About Markdown

- (Multi)Markdown

- Full Index

Overall Performance

Marked’s overall rendering speed and performance can vary greatly based on your settings in preferences and the type of content you have in your document. There are several factors that can lead to slow rendering or long delays:

- Rendering a Markdown document containing a lot of HTML. This will always take longer to process.

- Using the MultiMarkdown processor with the fenced code option enabled can lead to performance issues if there are a lot of code blocks in your document. Marked handles converting these outside of the standard processor, and there’s a small performance price to pay for the extra processing. In general, though, the fenced code option is well-optimized and can handle a programming book’s worth of code. If you have trouble in this area, consider using a custom processor with fenced code support built in.

- Using many includes. Whether it’s code includes or an index merge file, picking up all the pieces takes Marked a second. The same is true of large Scrivener documents. There’s not a lot you can do to fix this one, Marked will just do its best to keep up with the way you choose to structure your document.

- Hard drive condition. If your hard drive is almost full, your Spotlight index is corrupt or your permissions haven’t been repaired in a while, Marked may have a harder time picking up the changes to the file it’s watching. Optimizing your drive by repairing permissions will often help, and rebuilding the Spoglight index is often a fix for Marked issues.

top

Marked Help

- Getting Started

- Overview

- What's New?

- Marked Basics

- Opening Files

- Previewing

- Interface Features

- Exporting

- Especially for Writers

- Document Statistics

- Scrivener 2.0 Support

- Multi-file Documents

- Fountain (Screenwrite)

- Advanced Features

- Keyboard Shortcuts

- Scroll to Edit

- Toggle Header IDs

- Custom Processor

- Custom Styles

- Workflow Integration

- Marked Special Syntax

- Per-Document Settings

- MathJax

- For Programmers

- Troubleshooting

- Preview Not Updating

- Overall Performance

- Additional Help

- About Markdown

- (Multi)Markdown

- Full Index

Additional Help

If you have any other issues with Marked, you can search the Marked Knowledge Base for answers to your specific question. If you’re unable to find an answer, please feel free to file a ticket at the Marked Support site and we’ll help you just as soon as we’re able.

top

Marked Help

- Getting Started

- Overview

- What's New?

- Marked Basics

- Opening Files

- Previewing

- Interface Features

- Exporting

- Especially for Writers

- Document Statistics

- Scrivener 2.0 Support

- Multi-file Documents

- Fountain (Screenwrite)

- Advanced Features

- Keyboard Shortcuts

- Scroll to Edit

- Toggle Header IDs

- Custom Processor

- Custom Styles

- Workflow Integration

- Marked Special Syntax

- Per-Document Settings

- MathJax

- For Programmers

- Troubleshooting

- Preview Not Updating

- Overall Performance

- Additional Help

- About Markdown

- (Multi)Markdown

- Full Index

(Multi)Markdown

License and description.

Markdown vs. MultiMarkdown

MultiMarkdown (by Fletcher Penney) is an extension of Markdown (by John Gruber). All standard Markdown formatting is observed, and MultiMarkdown provides additional syntaxes for elements such as tables and footnotes.

Syntax

There’s a Markdown Syntax guide under the help menu, or you can refer to John Gruber’s original documentation.

MultiMarkdown extensions are documented by Fletcher Penney in this document.

MultiMarkdown License

AUTHOR

John Gruber â€¨http://daringfireball.net/
PHP port and other contributions by Michel Fortin â€¨http://michelf.com/
MultiMarkdown changes by Fletcher Penney â€¨http://fletcherpenney.net/

COPYRIGHT AND LICENSE

Original Markdown Code Copyright (c) 2003-2007 John Gruber â€¨http://daringfireball.net/ All rights reserved.
MultiMarkdown changes Copyright (c) 2005-2009 Fletcher T. Penney â€¨http://fletcherpenney.net/ All rights reserved.
Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

- Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.

- Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.

- Neither the name “Markdown” nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.

This software is provided by the copyright holders and contributors “as is” and any express or implied warranties, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose are disclaimed. In no event shall the copyright owner or contributors be liable for any direct, indirect, incidental, special, exemplary, or consequential damages (including, but not limited to, procurement of substitute goods or services; loss of use, data, or profits; or business interruption) however caused and on any theory of liability, whether in contract, strict liability, or tort (including negligence or otherwise) arising in any way out of the use of this software, even if advised of the possibility of such damage.

top

Marked Help

- Getting Started

- Overview

- What's New?

- Marked Basics

- Opening Files

- Previewing

- Interface Features

- Exporting

- Especially for Writers

- Document Statistics

- Scrivener 2.0 Support

- Multi-file Documents

- Fountain (Screenwrite)

- Advanced Features

- Keyboard Shortcuts

- Scroll to Edit

- Toggle Header IDs

- Custom Processor

- Custom Styles

- Workflow Integration

- Marked Special Syntax

- Per-Document Settings

- MathJax

- For Programmers

- Troubleshooting

- Preview Not Updating

- Overall Performance

- Additional Help

- About Markdown

- (Multi)Markdown

- Full Index

Index

- (Multi)Markdown

- Add Fountainâ€™s custom style

- Additional Help

- Additional features

- AppleScript

- Base header level

- Book Formats

- Choosing a style

- Clicking external links

- Copy HTML

- Copy Rich Text

- Custom Processor

- Custom Styles

- Document Statistics

- Drag to Dock Icon

- Environment variables

- Example Uses

- Exporting

- Fenced code blocks

- File includes

- For Programmers

- Fountain (Screenwrite)

- Full-Screen

- Gear Menu

- Github-style line breaks

- High Contrast

- Including code

- Including unprocessed text or html

- Inserting JavaScript

- Install Fountain

- Interface Features

- Keep on Top

- Keyboard Navigation

- Keyboard Shortcuts

- Markdown Headers

- Markdown Reference

- Markdown vs. MultiMarkdown

- Marked Bonus Pack

- Marked Special Syntax

- Marked metadata keys

- MathJax

- Metadata format

- Multi-file Documents

- MultiMarkdown License

- Notes on â€œScroll to Editâ€

- On the Command Line

- Open Recent

- Opening Files

- Overall Performance

- Overview

- Page breaks

- Per-Document Settings

- Per-document styles

- Preview Not Updating

- Preview formulas with MathJax

- Previewing

- Print/PDF

- Quotes language

- Readability Statistics

- Save HTML

- Save PDF

- Save RTF

- Scrivener 2.0 Basics

- Scrivener 2.0 Support

- Scroll to Edit

- Search

- Security Note

- Set up a custom processor

- Syntax

- Syntax Highlighting

- Table of Contents

- Text Zoom

- The latest stuff

- Time Machine

- Toggle Header IDs

- Using Textile as your markup language

- Using a custom processor

- Using custom styles

- Using the Menu

- View Source

- Visualize Word Repetition

- Watching CSS changes

- What's New?

- Whatâ€™s Markdown?

- Whatâ€™s Marked?

- Word Count and Document Statistics

- Word Count for Selection

- Workflow Integration

- Writing custom CSS

top