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
- macOS says the app “is damaged and can’t be opened.”
-
It isn’t damaged. OKMD is signed, but not with a paid Apple
developer certificate, so macOS quarantines anything downloaded from
the web that it can’t attribute to a registered developer. Drag
the app to your Applications folder, then run this once in Terminal:
It opens normally from then on, and you never need to do it again.xattr -dr com.apple.quarantine /Applications/OKMD.app - Why not just sign it properly?
- An Apple Developer account costs $99 a year, which is a lot for a free app that does one thing. If enough people use it, that changes. In the meantime the source is public, so you can read exactly what you’re running rather than take my word for it.
- 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.