// macOS app;

MarkDoc

A native Markdown editor for Mac. Edit in a clean WYSIWYG surface or drop into raw Markdown, keep your document structured with a drag-and-drop outline tree, and export to PDF, DOCX, or HTML when you're done.

Download for Mac View on GitHub

v0.2.0 · Universal · 218.7 MB· Free & open source (MIT)

Editing modes

One document, four ways to see it

Switch between Edit, Markdown, Preview, and Split from a native-style toolbar, a View menu item, or a keyboard shortcut. The underlying file is always plain Markdown.

MarkDoc's Edit view — Edit
WYSIWYG editing
Headings look like headings, bold looks bold, tables render as a grid. Syntax characters stay hidden until your cursor is on that line.

MarkDoc's Markdown view — Markdown
Raw source, when you want it
Drop into plain-text Markdown at any time: the same document, with no round-trip loss between the two views.

MarkDoc's Preview view — Preview
Final-form, read-only preview
No editing chrome, no syntax markers. Just the typeset document as it will look exported.

MarkDoc's Split view — Split
Source and preview, side by side
Raw Markdown and rendered Preview stay in sync as you scroll, so you can write with one eye on the result without losing your place.

What it does

Everything a Markdown file needs

Structure, navigation, and export, built around the file staying a portable, plain-text .md at every step.

An outline that mirrors your document

A live tree of every heading, built straight from the document with no manual maintenance. Click any node to jump the editor straight to it.

Drag to restructure

Drag a heading to reorder or re-nest it and MarkDoc moves the whole section with it, adjusting heading levels to match the new depth automatically.

Search and find & replace

Jump to headings and body text with a ranked search overlay, then find and replace across the whole document when you need to rename a term or fix a typo everywhere at once.

Export to PDF, DOCX, or HTML

Ship the same document as a shareable PDF, an editable Word file, or self-contained HTML, with Mermaid diagrams, tables, and per-document styling carried through.

Images that travel with the file

Insert from your computer or a URL. Local images are copied into a co-located .assets folder so relative paths stay portable when you move or share the Markdown file.

Quick Look, right in Finder

A native Quick Look extension renders Markdown as formatted HTML the moment you hit Space on a file, without opening the app first.

Updates itself

MarkDoc checks GitHub Releases in the background and prompts you to restart once an update is ready. It never does this while a document has unsaved changes.

Command line

Open files from the terminal

Install the markdoc command from Preferences → Install markdoc CLI, the same way VS Code's code command works. MarkDoc holds a single-instance lock, so opening another file hands off to the already-running window instead of launching a second copy of the app.

sh

markdoc notes.md              # Open a file
markdoc doc1.md doc2.md       # Open multiple files
markdoc                       # Activate app / new blank document
markdoc --new-window file.md  # Force new window

Under the hood

Built with

Electron
React
Tiptap / ProseMirror
Tailwind CSS
@dnd-kit
minisearch
Mermaid
docx
Vitest + Playwright

Local-first, no accounts, no telemetry. Your documents never leave the machine unless you export or share them yourself. Read the functional, technical, and design docs in the repo for the full detail behind every feature above.

Get MarkDoc

Version 0.2.0 is out now

Packaged as a universal macOS app for Apple Silicon and Intel, signed and notarised. Free and open source under the MIT licence, with no account and no subscription.

Download MarkDoc.dmg Release notes for v0.2.0 →

218.7 MB · macOS · Universal (Apple Silicon and Intel)