# Marked Quick Look

Marked Quick Look is a separate Mac App Store app that adds a Quick Look preview extension for Markdown and plain-text files. Press Spacebar in Finder (or use Quick Look anywhere macOS supports it) to see a styled HTML preview instead of raw source.

Marked Quick Look is not included with Marked 3. It is a separate purchase ($4.99 on the Mac App Store).

> Marked Quick Look and Marked 3 are independent products. Buying Marked does not install the Quick Look extension, and buying Marked Quick Look does not include a Marked license. The preview includes an optional Open in Marked button when Marked is installed.

Contents

- What you get
- Installation
- Apex and Markdown flavors
- Open in Marked
- Troubleshooting Quick Look conflicts
- Related topics

## What you get

Marked Quick Look registers a Quick Look Preview extension that renders `.md`, `.markdown`, `.mmd`, and many plain-text files with the same visual polish Marked is known for:

- Apex processing — powered by Apex, an open-source Markdown processor that supports CommonMark, GitHub Flavored Markdown, MultiMarkdown, Kramdown, and a Unified mode that combines features from multiple flavors
- Marked preview styles — nine built-in themes (GitHub by default) plus custom CSS import
- Syntax highlighting, MathJax, and Mermaid diagrams (bundled scripts; no network required)
- CriticMarkup in markup view
- Open in Marked — jump from Quick Look to the full Marked preview when Marked is installed

> Quick Look previews are read-only. File includes (`<<[file]`, `{{file}}`, and similar syntax) are not expanded in Quick Look. They appear as highlighted placeholders (`Included file: path`) so you can see where content would be pulled in. Open the document in Marked for full multi-file rendering.

## Installation

1. Install Marked Quick Look from the Mac App Store.
2. Launch the app once from `/Applications`. This registers the Quick Look extension with macOS.
3. Press Spacebar on a Markdown file in Finder to preview it.

The container app includes a Settings window (`⌘`,`,`) where you can choose the Apex processor mode, preview style, syntax-highlighting theme, and toggles for MathJax and Mermaid.

## Apex and Markdown flavors

Marked Quick Look uses Apex for all rendering. Apex is developed as a standalone processor and is also embedded in Marked 3.

In Settings, choose an Apex mode to match your writing style:

Mode | Best for
--- | ---
Unified (default) | Mixed Markdown features across flavors
CommonMark | Strict CommonMark
GFM | GitHub Flavored Markdown
MultiMarkdown | Metadata, transclusion, footnotes
Kramdown | Kramdown-style extensions

Unified mode is the best default for most documents. Switch modes if a file was written for a specific processor and something renders unexpectedly.

## Open in Marked

When Marked 3 is installed, the Quick Look preview can show an Open in Marked button in the toolbar. Click it to hand the file off to Marked for live preview, export, proofreading, and full include expansion.

If Marked is not installed, the button appears disabled.

## Troubleshooting Quick Look conflicts

macOS allows multiple apps to register Quick Look preview extensions for Markdown. Only one extension handles each preview, and another app’s plugin may take precedence over Marked Quick Look.

### How to tell which extension is active

Marked Quick Look previews include an Open in Marked toolbar when that option is enabled. If you see a different layout, raw monospace source, or another app’s styling, a different Quick Look handler is probably winning.

### Restore Marked Quick Look precedence

After installing or updating, or after resetting the Quick Look cache, run these steps:

1. Launch Marked Quick Look once from `/Applications` (or Run from Xcode if you are testing a development build).
2. In Terminal, register and prefer the extension:

    pluginkit -a "/Applications/Marked Quick Look.app/Contents/PlugIns/MarkedQuickLookPreview.appex"
    pluginkit -e use -i com.brettterpstra.MarkedQuickLook.preview

3. Reset Quick Look services:

    killall quicklookd QuickLookUIService 2>/dev/null

4. Press Spacebar on a `.md` file again.

To clear cached previews:

    qlmanage -r cache

### Temporarily disable a conflicting extension

To confirm another app is overriding Marked Quick Look, disable its extension with `pluginkit -e ignore -i BUNDLE_ID`, preview a file, then restore with `pluginkit -e default -i BUNDLE_ID`.

Example — disable Folder Quick Look’s Markdown extension:

    pluginkit -e ignore -i studio.appahead.AA7.Markdown-Quick-Look-Extension

### Common conflicting apps

These apps (and others) register Quick Look preview extensions that may handle `.md` files:

App | Bundle ID (preview extension)
--- | ---
Folder Quick Look | `studio.appahead.AA7.Markdown-Quick-Look-Extension`
QLMarkdown | `org.sbarex.QLMarkdown.QLExtension`
Peek | `com.bigzlabs.peek.peekextension`
Highland Pro | `com.quoteunquoteapps.highland.pro.qlplugin`
Bear | `net.shinyfrog.bear.Bear-Quicklook-Extension`
Ulysses | `com.soulmen.ulysses-setapp.quicklookextension` (Setapp) / `com.soulmen.ulysses.quicklookextension`
Drafts | `com.agiletortoise.Drafts-OSX.Drafts-OSX-QuickLookPreview`
Scrivener | `com.literatureandlatte.scrivener3.ScrivQuickLook`
Black Ink | `com.red-sweater.blackink2.quicklook`

> iA Writer does not ship a dedicated Markdown Quick Look extension, but Folder Quick Look, QLMarkdown, and Peek are frequent sources of conflicts because they also target `net.daringfireball.markdown`.

List registered preview extensions:

    pluginkit -m -D -p com.apple.quicklook.preview -A -v | grep -i markdown

Extensions marked with `+` are explicitly enabled; use `pluginkit -e use -i com.brettterpstra.MarkedQuickLook.preview` to move Marked Quick Look to the front.

### Still seeing plain text?

If the preview shows unstyled monospace source, macOS may be falling back to the built-in Text.qlgenerator because the preview extension failed to load. Check Console.app for errors from `MarkedQuickLookPreview`, then reinstall Marked Quick Look to `/Applications` and launch it once.

### Development builds

Debug builds from Xcode live in DerivedData and do not register automatically. Run the Marked Quick Look container app from Xcode (Cmd+R) after each clean build, then re-run the `pluginkit -a` and `pluginkit -e use` commands with the DerivedData path to your `.appex`.

## Related topics

- Opening Files — how Marked opens and watches documents
- Multi-file Documents — include syntax and full expansion in Marked
- Choosing a Processor — processor options inside Marked 3
- Share Extension — send files to Marked from the system Share menu

#### Next up: Quick Open ▶

Support Site | Legal | Privacy