Support
Bug Reports & Feature Requests
The best way to report a bug or request a feature is to open an issue on GitHub:
Please include as much detail as possible — the Markdown file that caused the issue, your macOS version, and steps to reproduce.
Frequently Asked Questions
How do I set Open Markdown as the default app for .md files?
Open System Settings → Default Apps (macOS 14+) or use Finder: right-click any .md file, select Get Info, choose Open Markdown under Open with, then click Change All.... See the documentation for details.
Does the app auto-update?
If you installed from the Mac App Store, the app updates automatically based on your App Store settings. If you downloaded directly from GitHub, grab the latest version from the GitHub Releases page.
Does Open Markdown send any data over the network?
No. The app operates entirely offline. No analytics, telemetry, or network requests of any kind. See the privacy policy for details.
Which macOS versions are supported?
Open Markdown supports macOS 13 (Ventura) and later.
Can I use it to edit Markdown?
Open Markdown is a read-only viewer. For editing, use your favourite text editor — the app will live-reload the preview whenever you save.
My Mermaid diagram isn't rendering. What should I do?
Ensure the code block uses the mermaid language tag. Check the Mermaid docs for supported syntax. If the diagram is valid but still not rendering, please open an issue.