VAYS MD Reader app icon VAYS MD READER · For Mac

Your AI writes Markdown all day. Read it beautifully.

A native macOS Markdown viewer and editor for the .md files piling up in your repos: CLAUDE.md, READMEs, specs, transcripts, plans. Real typography instead of source code. No Electron, no servers, and a free iPhone companion that picks up exactly where you left off.

VAYS MD Reader rendering an agent-written document with a front-matter card, badges, callouts and tables

A Markdown viewer built for the AI era.

Coding agents like Claude Code produce Markdown constantly: CLAUDE.md instructions, README files, migration plans, research notes, meeting transcripts. Code editors show them as raw source; browser-based tools ship an entire Chromium to display a text file. VAYS MD Reader is the missing piece: a fast, native macOS app whose only job is making Markdown a pleasure to read and easy to edit.

It renders GitHub Flavored Markdown the way GitHub does (tables, task lists, strikethrough, autolinks) and keeps going where most viewers stop: callout cards, footnotes, YAML front matter as a metadata card, shields.io badges drawn natively, LaTeX math typeset without a web view, and Mermaid diagrams rendered by an engine that ships inside the app, fully offline.

Everything in detail

Reading, done right

  • ✓ GitHub Flavored Markdown: tables, task lists, autolinks
  • ✓ Callout cards: GitHub [!NOTE] / [!TIP] / [!WARNING] and Obsidian [!summary]
  • ✓ Footnotes, front-matter cards, native shields.io badges
  • ✓ LaTeX math, display and inline, typeset natively, no web view

Mermaid, offline

  • ✓ Flowcharts, sequence, gantt, class, ER, pie, mindmaps
  • ✓ The engine ships inside the app, zero network
  • ✓ Draw diagrams visually: drag nodes, connect arrows
  • ✓ The Mermaid source writes itself as you draw

A real editor too

  • ✓ Read / Edit / Split modes with synchronized scrolling
  • ✓ Markdown syntax highlighting, autosave, native find
  • ✓ Insert gallery: tech badges, README emoji, snippets
  • ✓ External-change detection with conflict handling

Your whole library

  • ✓ Add a projects folder once, browse every repo as a tree
  • ✓ Favourites, collapsible sections, drag & drop
  • ✓ Quick open searches file names and file contents
  • ✓ Links between .md files open in-app, with history

Everywhere on your Mac

  • ✓ QuickLook: space bar previews any .md in Finder
  • ✓ Copy as rich text: paste into Gmail, Docs, Slack
  • ✓ Export to PDF, Word and HTML; pinned tabs, focus mode
  • ✓ Live reload: watch your AI agent write in real time

Private by design

  • ✓ Zero network requests by default: verified, not promised
  • ✓ No account, no analytics, no crash SDKs
  • ✓ Files stay plain .md on disk, where they were
  • ✓ Sandboxed, hardened runtime, App Store reviewed

Annotate, never modify

  • ✓ Highlights, comments and saved snippets on any fragment
  • ✓ Highlighter mode: click or sweep across whole blocks
  • ✓ Stored in a sidecar file; the .md is never touched
  • ✓ Copy all annotations as a Markdown digest

Ask your document: local AI

  • ✓ Chat with the open document via Ollama on your Mac
  • ✓ Quote a fragment and ask about exactly that
  • ✓ Fully offline, no API keys, no cloud
  • ✓ Works with any local Ollama model

The From Claude inbox

  • ✓ A copy-paste hook auto-opens every .md your agents write
  • ✓ Arrivals grouped by project and session, unread until read
  • ✓ Session-colored tabs: five agents stay five threads
  • ✓ Provenance on hover: project, session, source path
New · Free iPhone companion

Leave the desk. Keep reading.

Claude just finished the report, and you're heading out. One shortcut (⇧⌘E) sends the open document to your iPhone through your private iCloud Drive. It lands in the free Vays Markdown reader app and opens at the exact heading you were on. Turn on auto-send and every file your agents write is waiting on your phone before you reach the door.

  • ✓ From Mac queue on the iPhone home screen, with project chips for agent-written files
  • ✓ Opens at the heading you were reading, not at the top
  • ✓ Handoff: the reader icon appears on your iPhone while you read on the Mac
  • ✓ Your iCloud, zero servers; off by default, one toggle to enable

Sending from the Mac requires VAYS MD Reader for Mac and the same iCloud account on both devices. Reading local files on iPhone is free, no Mac needed.

Continue reading on iPhone: a document sent from VAYS MD Reader on the Mac appears in the From Mac list on the free iPhone companion app

How it compares.

Free viewers show you the file. Editors want to own your notes. VAYS MD Reader sits exactly where AI-era work happens: reading first, editing when needed, everything local.

Capability VAYS MD Reader Free viewers Marked 2 Typora Obsidian
Native app, no Electronvaries
Mermaid rendered fully offlinevaries
Draw diagrams visually
GitHub + Obsidian callout cardsvaries~
QuickLook preview in Findervariesadd-on
Copy as rich text (Gmail, Docs)
Live reload for AI-agent workflowsvaries~
Reads your folders in place, no vault
No account, no telemetryvaries~
Zero network requests by defaultvaries
Annotations that never touch the file~
Built-in local AI chat (Ollama)~
Agent inbox with session provenance
Continue reading on iPhone (free app)~

Comparison based on publicly documented features, September 2026. Product names belong to their owners.

Made for AI workflows

Watch your agent write.

Open a document and let Claude Code keep writing; the reader re-renders on every save. One copy-paste hook auto-opens every .md your agents write, and each file lands in the From Claude inbox: grouped by project and session, unread until you look, provenance on hover. Five parallel sessions stay five tidy threads. When the plan is ready, copy it as rich text straight into an email, or let auto-send drop it on your iPhone so you can review it on the way.

Part of the VAYS family: record a memo in VAYS, read the transcript in VAYS MD Reader; the inbox connects with one click. Same private-AI foundation, same rule: everything stays on your device.

Meet VAYS →
The From Claude inbox in VAYS MD Reader: agent-written files grouped by project and session with unread indicators
Questions

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.

VAYS MD Reader

Read your Markdown the way it deserves.

On the Mac App Store now. One price, no subscription, private forever.