resolve

---

Drop a .md on the icon (or set Markdown Preview as your default handler) and get a clean, scrollable preview with a real document outline — no Electron, no browser tab.

Installation

Markdown Preview is available in the official Homebrew cask repository:

brew install --cask markdown-preview

Or grab the latest signed and notarized DMG from the Releases page.

Screenshots

Features

App language: Choose Settings → General → Language to use a bundled translation independently of your system language. Quit and reopen the app to apply the choice to settings, menus, and document controls. System Default removes the app override and follows macOS again. This preference persists across launches and affects only the app; Quick Look previews continue to use their system-selected language. Available languages are discovered from the app’s bundled translations.

Settings groups window behavior, saving, and external tools under General. Reading contains text size, content width, text alignment, Markdown line breaks, and outline highlighting. Appearance contains themes and their font, spacing, and color customization; resetting a theme leaves global Reading preferences unchanged.

Text alignment: Choose Settings → Reading → Text & layout → Text alignment for Automatic, Left, Center, Right, or Justified prose. Automatic preserves the document’s existing alignment, including right-to-left text. This global preference persists across launches and theme changes, updates open reading views immediately, and applies to Quick Look when reopened. Code, tables, and explicit HTML alignment remain unchanged. Justification leaves the final paragraph line naturally aligned; enable Strict line breaks to join ordinary source wraps into flowing paragraphs.

Single source newlines remain visible by default. Enable Settings → Reading → Markdown → Strict line breaks to let ordinary source lines flow into paragraphs in reading view and Quick Look. Two trailing spaces or a backslash still create an explicit line break; blank lines still separate paragraphs. Reopen an existing Quick Look preview after changing this setting.

• Native rendering — WKWebView pipeline backed by swift-markdown, with heading anchors and link handling. Bare http:// and https:// URLs are clickable in the app and Quick Look previews.
• Read Mode — select and copy text, follow links, and browse tables. Click task checkboxes to save each change directly to the file. Tables and Quick Look previews remain read-only. Table words and inline code retain their natural widths; wide tables scroll horizontally. In Read or Edit mode, use Expand Table above a table to open a read-only fullscreen snapshot. Press Escape or close the table window to return to the document.
• App links — Read Mode and Quick Look support custom URL schemes. Before opening an unapproved custom link with a registered app, a compact dialog names the app and offers Cancel, Allow, and Always Allow, with Cancel as the default. For an unapproved custom link with no registered app, an alert reports that no application can open the link. Use Copy Link in the context menu to inspect the destination. “Always Allow” saves approval for that URL scheme across documents, app restarts, and Quick Look. Reset approvals in Settings → General → App links. HTTP, HTTPS, mailto, and the app’s own md-preview: links open without this prompt, even after resetting approvals. Executable URLs and literal file:// links remain blocked; embedded resources cannot launch custom app links.
• Edit Mode — edit Markdown in place with a formatting toolbar for headings, emphasis, lists, quotes, code, and links. Table cells show inline formatting until focused, then reveal their Markdown syntax for editing. Task markers become checkboxes once you finish typing the closing bracket; Enter continues a task list, and Enter on an empty task exits it. Toggle it from the toolbar or with ⌘E, then save with ⌘S.
• Mermaid diagrams — fenced mermaid code blocks render as diagrams in both the app and Quick Look previews, using a bundled renderer so previews work offline without a CDN request.
• Math equations — LaTeX inline ($x_1 + x_2$), display ($$\int_0^1 x^2\,dx$$), and fenced math blocks render with a bundled KaTeX. Selecting a rendered formula and copying yields the original LaTeX source (via the official copy-tex extension).
• Document outline — sidebar TOC that mirrors your headings; click to jump.
• Collapsible sidebar — the outline and file picker hides when the sidebar collapses; the sidebar toggle stays available to reopen it.
• File navigator — browse Markdown files in the sidebar. Click a folder's name, icon, or empty row space to expand or collapse it, or use its disclosure triangle. Click a file to open it in the current reading or editing mode.
• Inspector panel — toggleable side panel with file metadata.
• In-document search — toolbar search field plus standard ⌘F / ⌘G / ⌘⇧G for next/previous match.
• Search for Document — find a file by name, as against searching inside one. ⇧⌘O, or a toolbar button you can drag in via View → Customize Toolbar…, opens a draggable floating palette over the current document, with native Liquid Glass on macOS 26 and later (Escape or clicking outside dismisses it); the palette remembers where you drag it relative to the document window and stays on that window’s current screen; the empty query shows up to 10 recently opened files across folders, newest first, including when no document is open. Typing keeps matching recents above project file results without duplicates; clearing the query restores recents. History persists across launches and