Support

OKMD is a markdown reader and editor for the Mac, with one control in it.

Email [email protected] and I’ll get back to you. It helps to say which version of macOS you’re on. Bugs are better as issues on GitHub, where they don’t get lost.

Frequently asked

How do I install it?

Download OKMD-mac-arm64.zip, unzip it, and drag OKMD.app into your Applications folder. It is signed and notarized, so it just opens.

Does it run on an Intel Mac?

Not yet. The current build is Apple silicon only, and needs macOS 12 or later. If you want an Intel build, say so — it is a build setting, not a rewrite.

Can I edit, or only read?

Both, and you can do it in either view. Type directly into the formatted preview and the markdown updates underneath; or press ⌘E and edit the raw text. Saving always writes markdown.

Where did my file go? I don’t see a file list.

There isn’t one, on purpose. Every document gets its own window, the way TextEdit and Preview work. A window with nothing open shows your recent files. If you want them side by side, macOS tabs work — Window ▸ Merge All Windows.

Does it work offline?

Always. OKMD contains no network code whatsoever. The markdown parser and the syntax highlighter are bundled into the app rather than loaded from a CDN, so nothing is ever fetched.

Does it sync between my devices?

No. There is no account and no server. Your files are wherever you put them, and syncing them is iCloud Drive’s job or Dropbox’s, not this app’s.

How do I update it?

Download the newer version from Releases and replace the app. There is no updater and no update check, which also means the app never phones home to ask.