Unmarked# Unmarked Support
How can we help?
Guides for opening, reading, writing, and presenting Markdown with Unmarked, plus clear answers about privacy and your files.
Getting started
Opening & files
- Make Unmarked your default Markdown appSet Unmarked as the default app for .md files on your Mac with Finder's Get Info, so every Markdown file opens in Unmarked on a double-click.
- How to open a Markdown file on MacOpen a Markdown file on Mac in Unmarked three ways: double-click it in Finder, use Open (⌘O), or drag it onto the app. Files open in place.
- Open Markdown files made in other appsUnmarked opens standard Markdown files made in other editors, in place. No import, no conversion.
- When another app changes your fileWhen an AI assistant, a script or another editor changes the Markdown file you have open, Unmarked reloads it on its own and keeps your place.
- Which file types Unmarked opensUnmarked opens .md, .markdown, .mdown, .mkd, and plain .txt files, reading each as Markdown. It supports CommonMark plus GitHub extensions.
Reading & writing
- Change the theme in UnmarkedPick one of five Unmarked themes in Settings (⌘,) under Appearance, then choose System, Light, or Dark. The theme also carries into Present.
- Check off task-list itemsTask-list checkboxes in Unmarked are interactive. In Read mode, click a box to tick or untick it and the change saves to the file. In Write mode, press ⌘L.
- Present a Markdown document as slidesTurn the open Markdown document into full-screen slides in Unmarked. Headings and dividers set the slide breaks, and ⌥⌘P starts the presentation.
- Read and Write modesUnmarked has two modes: Read shows the finished document, Write shows clean source with the syntax revealed at your cursor. Press ⌘E to switch.
- Set your reading and writing fontsSet the font, text size, line spacing, and width for Reading and Writing separately in Unmarked's Settings (⌘,). Present uses your reading font.
- Use the outline sidebarUnmarked's outline sidebar lists every heading in your Markdown document, nested by level, and marks the one you're reading. Click a heading to jump to it.
- See the word count as you writeUnmarked shows a live word count in the status bar at the bottom of the window. Click it to count characters or sentences instead, or hide it.
Markdown in Unmarked
- Frontmatter shown as a properties panelUnmarked reads YAML frontmatter at the top of a Markdown file and shows it as a clean two-column properties panel, with humanized key names. Keep or strip it on export with one toggle.
- Render Mermaid diagrams in UnmarkedWrite a Mermaid code block and Unmarked draws it as a diagram in Read mode and Present: flowcharts, sequence diagrams, and more, rendered on your Mac.
- What Markdown Unmarked rendersEverything Unmarked renders: CommonMark, GitHub tables, task lists and strikethrough, YAML frontmatter, LaTeX math, colored code blocks and Mermaid diagrams.
- What Unmarked does not render yetFootnotes show in Unmarked as the plain text you typed, and web images show their alt text. What you'll see for each, and how to make web images render.
- Write math in Markdown with UnmarkedType LaTeX between dollar signs and Unmarked typesets it in Read mode, Present, PDF and Print, then exports it as MathML or as real Word equations.
Exporting & sharing
- Copy as rich text, Markdown, or HTMLCopy Markdown as clean formatted text for Mail, Slack, Docs, or Notion, with no syntax symbols. Unmarked also copies the raw Markdown or an HTML snippet.
- Export Markdown to self-contained HTMLExport Markdown to HTML in Unmarked: one self-contained file with CSS, images and colored code inside, or minimal markup to style yourself. Math becomes MathML.
- Export a Markdown file to PDFLetter or A4, margins, page numbers and a running header: Unmarked's PDF export paginates properly and typesets equations as vector text.
- Export Markdown to Word (.docx)Get a .docx from Unmarked that opens with Word heading styles, real lists and tables, embedded images, and equations you can keep editing.
- Print a Markdown filePrint a Markdown file on Mac with Unmarked: press ⌘P. Print uses the same renderer as PDF export, so the paper matches the PDF. No printer? Save as PDF.
Privacy & your files
- How Unmarked keeps your files privateUnmarked makes no network connections of its own: no analytics, no account, no cloud. It edits the file you open in place, and nothing is uploaded or copied.
- Where your edits are saved in UnmarkedUnmarked saves your edits to the file you opened about 2 seconds after you stop typing. No Save button, no hidden copies. New documents save once with ⌘S.
- Why remote images show as alt textUnmarked doesn't fetch anything from the internet, so an image linked from a web URL shows its alt text. Images stored next to your file render in every mode and export.
Troubleshooting
Reference
- Unmarked keyboard shortcutsEvery Unmarked keyboard shortcut on macOS, grouped by area: files, modes, presenting, formatting, Insert menu, export, and editing, plus how to set your own.
- Unmarked system requirementsUnmarked needs macOS 15 (Sequoia) or later and runs natively on Apple silicon and Intel Macs. It's free on the Mac App Store, about 15 MB installed, no account.
FAQ
Contact
Didn’t find it?
A real person reads every message. Contact us.