Simple .md · Support

Something not working?

Email us. A real person reads it.

Contact support

Anything at all: bugs, questions, requests.

simple-md@got2.app

For a bug report, include your macOS version and the version of Simple .md you are running. Nothing is sent automatically; your email stays a draft until you choose to send it.

What it needs

macOS 13 or later. It’s free, and version 1.0 is coming to the Mac App Store.

Things that come up

Is Simple .md free?

Yes. Simple .md is free, and requires macOS 13 or later.

Does Simple .md need an account or sign-in?

No. There’s no account, no sign-in, and no analytics — nothing about you is collected at all.

Does Simple .md work offline?

Yes. Everything happens on your Mac; nothing about you, your machine, or your documents is gathered, transmitted, or stored anywhere else.

What are themes?

Simple .md has three: Paper, Crisp and Editorial. A theme changes the paper, the type and the window around them, and each has a light and a dark side that follows your Mac. Choose one from the Theme menu; hovering one shows a small sample beside the menu, and your document does not change until you choose.

The same document in Simple .md’s Paper theme: a sans-serif typeface on warm paper, with the headings listed in a sidebar
The same document in Simple .md’s Editorial theme: a serif typeface on a pale page, with the headings listed in a darker sidebar
The same document in Paper and in Editorial.

A theme is yours, not the document’s. Choosing one changes nothing in your markdown file. It applies to every open window and to whatever you open next, and it is still your choice after you quit and come back. Exported HTML carries the theme’s paper and type. Like the app, it follows the reader’s light or dark setting, and the typeface falls back to a similar one where the theme’s font isn’t installed. A PDF is the rendered document on white paper, without the outline or toolbars.

Images in my document don't appear

An image beside your file — ![](images/chart.png) — sits in a folder Simple hasn't been given access to. The first time one fails to load, Simple asks once whether to show images from that folder. Choose Folder…, pick it, and Simple remembers, including after you quit. Choose Not Now and the images stay hidden in that window; click a missing image to be asked again.

My bullets changed from * to -

Deliberate. Saving normalises the markdown: hand-wrapped lines are joined, table columns are padded to line up, and * bullets become -. Your words are unchanged. Saving a second time changes nothing further. If you keep files in git, expect one noisy diff the first time a document goes through the editor.

One change is easy to miss. A link written as [text][ref], with its address on its own line lower down, is saved with the address inside the link. The address lines themselves are kept, gathered at the end of the document, so a list of sources at the foot of a draft stays in your file. Tags you type by hand, such as an opening <u> or <span> with no closing tag, come back exactly as you wrote them; only a matched pair takes effect.

Underline and coloured text are stored as HTML

Underline and colour are two of the three exceptions to plain markdown; the properties card is the third. Markdown has no underline and no colour, so Simple writes them as HTML: a <u> tag and a <span>. It is still valid markdown and nothing will choke on it, but the styling may not survive elsewhere: GitHub keeps the words and drops inline colour, and converters targeting Word or PDF discard raw HTML rather than translating it. Everything else Simple writes is either ordinary markdown or a widely supported extension: callouts use GitHub’s alert syntax, and a code block’s title is written on its opening fence. If a document has to look the same everywhere, leave underline, colour and the properties card alone.

My document’s properties have a theme: line. Will Simple change it?

No. Simple does not read a theme: line: the window is in your theme, whatever the document says, and the line stays exactly where it is. Simple writes a tables: line into a document’s properties only when you choose a table format. Pressing the properties button on a document that has none starts an empty title: line for you to fill in.

How do I make it my default markdown reader?

Right-click any .md file in the Finder, choose Get Info, set “Open with” to Simple .md, then click Change All.

Can I edit the markdown directly instead?

Yes. Click Aa or M↓ in the title bar, or press ⌥⌘S (View > Edit in Markdown) to switch between the markdown and the rendered text. Your cursor comes with you, to the same word, as long as it is on screen when you switch. The centre pane is the Editor, and it is what you type into in either view. Open the Viewer beside it and the other view sits there for looking at — it never accepts typing. The outline works the same in either view. Find works in both: it searches the markdown itself when you are in the markdown, and the words you see when you are in the rendered text. The formatting toolbar is for the rendered text.

Which version am I running?

Simple .md > About Simple .md. The app never checks for updates itself; instead the App Store tells you when one is ready, and installs it for you if you have automatic updates turned on.

Where is the help?

Help > Simple .md Help, or ⌘?. It opens in a window of its own inside Simple, and the Help menu’s search field searches it.

Tell us what to build next

We want to hear from you. What you tell us shapes how this tool evolves.

Bugs are not the only thing worth writing about. If something is awkward, or missing, or you have quietly built a habit of working around it, that is worth knowing, and it is a shorter message than you think. “This bit is annoying” is enough to start from.

Same address as everything else: simple-md@got2.app, with Idea in the subject if you want it to land in the right pile.