Show HN: Marky – A lightweight Markdown viewer for agentic coding

A fast, native markdown viewer for macOS built with Tauri v2, React, and markdown-it. Beautiful rendering of tables, code blocks, task lists, math, and diagrams — with live reload.

Marky is a desktop markdown viewer designed for one thing: opening .md files from the terminal and getting beautiful, instant rendering. Launch it with marky FILENAME to view a file or marky FOLDER to open a folder as a persistent workspace (Obsidian-style). Files reload live as they change on disk — perfect for viewing Claude-generated plans, documentation, or notes as they're being written.

CLI-first—marky README.md opens a window. marky ./docs/ opens a folder. Live reload— edits on disk (from your editor, Claude, etc.) update the view instantly. Folders— add folders as persistent workspaces (Obsidian-style). They appear in a sidebar and restore on launch. Cmd+K command palette— fuzzy-search files across all open folders, powered by nucleo. Syntax highlighting— Shiki with VS Code themes for accurate, beautiful code blocks. Math— KaTeX rendering for $inline$ and $$display$$ math. Mermaid diagrams— fenced mermaid blocks render as SVG. GFM— tables, task lists, strikethrough, autolinks, footnotes. Light & dark themes— follows system preference or toggle manually. Sanitized rendering— all HTML is run through DOMPurify. Safe to view untrusted markdown. Small & fast— native webview, no Electron. Production .dmg is under 15 MB.

NOTE: I am currently waiting for apple developer review so for the time being the app is not signed. This will be fixed soon.

brew tap GRVYDEV/tap
brew install --cask GRVYDEV/tap/marky
# This is temporary until I can sign the binary
xattr -cr /Applications/Marky.app

Requires Rust, Node.js, and pnpm.

git clone https://github.com/GRVYDEV/marky.git
cd marky
pnpm install
pnpm tauri build
./scripts/install-cli.sh

# Open a single file
marky README.md
# Open a folder as a workspace
marky ./docs/
# Open with no args — restores your last session
marky

| Shortcut | Action | |---|---| | Cmd+K | Command palette (fuzzy file search) | | Cmd+O | Open file | | Cmd+Shift+O | Add folder | | Cmd+F | Search in page |

Roadmap:

• x86 & Linux support— currently macOS ARM only; expanding to x86 macOS and Linux
• Built-in AI chat— chat with Claude Code or Codex directly inside your markdown documents
• Git diff review— view and review local git diffs without leaving the app