What's the best way to read Markdown on a Mac?
In a viewer made for it. VAYS MD Reader renders .md with real typography, and its QuickLook extension means the space bar previews any Markdown file straight in Finder, before you even open the app.
Do Mermaid diagrams really work offline?
Yes, the engine is bundled inside the app. Flowcharts, sequence diagrams, gantt, mindmaps: all render with zero network access. You can also draw flowcharts and sequence diagrams visually and the source is generated for you.
Does it work with Claude Code?
That's what it was built for. A copy-paste hook opens every .md your agents write, the From Claude inbox groups arrivals by project and session, and open documents re-render on every save: you watch the agent write in real time. Full-text search covers every repository in your library.
Is my data private?
Yes, by default: no account, no analytics, no cloud, zero network requests. Files stay as plain .md on your disk; remove a folder from the library and the app never sees it again. The optional iPhone hand-off copies documents into your own iCloud Drive; we run no servers and never see your files.
Can I highlight and comment without changing the file?
Yes. Highlights, comments and snippets live in a sidecar next to the document; the .md itself is never modified. Annotations survive agent rewrites thanks to smart text anchoring, and you can copy them all as a Markdown digest.
Does it have AI features? Do they stay private?
Ask Document connects to Ollama running on your Mac: chat with the open file, or quote a fragment and ask about exactly that, fully offline, no API keys, no cloud. If you don't use Ollama, the app makes zero network requests of its own.
Can I keep reading on my iPhone?
Yes: send any document to the free Vays Markdown reader app with ⇧⌘E. It syncs through your private iCloud and opens at the heading you were on. Agent-written files can go automatically, and Handoff puts the reader icon on your iPhone's lock screen while you read on the Mac.
Is there a free version?
The iPhone and iPad companion is free: open and read any Markdown file natively on iOS. The Mac app is a one-time purchase, no subscription.