MinimalMD

Help

MinimalMD Support

Questions, problems or ideas — we'd like to hear them.

Email
turn on JavaScript to see the address

Report a bug or request a feature
GitHub Issues

If a document looks wrong, please attach a screenshot and, if you can, the Markdown file itself.

Frequently asked questions

Where do I get MinimalMD?

MinimalMD is free on the Mac App Store and requires macOS 15.6 Sequoia or later.

Why don't the images in my document show?

macOS lets MinimalMD read only the files you open. For images stored next to your document, a bar appears at the bottom of the window — choose the folder there to grant access. You can review and revoke access at any time in Settings → Privacy. Images on the web are never loaded: MinimalMD makes no network connections.

Quick Look doesn't show my Markdown files rendered.

Open MinimalMD once after installing it, so macOS registers its Quick Look extension. If previews still show plain text, check that MinimalMD is turned on in System Settings → General → Login Items & Extensions → Quick Look.

How do I make MinimalMD my default Markdown app?

Open Settings → General and choose Set as Default. macOS asks you to confirm the change.

How do I give Markdown files back to my previous app?

Open Settings → General and choose Restore next to “Give it back to …”. That row appears while MinimalMD is the default and your previous app is still installed. Otherwise, select any Markdown file in Finder, choose File → Get Info, pick an app under Open with, and click Change All.

Can I edit my files with MinimalMD?

No — MinimalMD is a viewer and never changes your files. To edit a document, open it in your editor. To take its text elsewhere, use Edit → Copy Document as Markdown.

Part of my document shows as raw Markdown or HTML.

That's deliberate: anything MinimalMD can't render faithfully is shown as its source rather than hidden. If you think it should be rendered, please send us the document. See what MinimalMD renders.

Which languages does MinimalMD support?

English, French, German, Italian, Russian and Spanish, following the language set for your Mac. Spotted a translation mistake, or want MinimalMD in your language? Let us know.

What changed in the latest version?

Every release and its changes are listed in the changelog, newest first.