Marky: A Lightweight Markdown Viewer for Agent-Generated Documentation

What Marky Does

Marky is a native desktop application for macOS that provides fast rendering of markdown files with a focus on terminal integration. You can launch it with marky FILENAME to view a single file or marky FOLDER to open a folder as a persistent workspace.

Key Features

• CLI-first workflow: Open files directly from terminal commands
• Live reload: Edits on disk update the view instantly, useful for viewing Claude-generated plans or documentation as they're written
• Folder workspaces: Add folders as persistent workspaces that appear in a sidebar and restore on launch
• Command palette: Cmd+K for fuzzy-search files across all open folders using nucleo
• Syntax highlighting: Shiki with VS Code themes for accurate code blocks
• Math support: KaTeX rendering for $inline$ and $$display$$ math
• Diagrams: Mermaid blocks render as SVG
• GFM support: Tables, task lists, strikethrough, autolinks, footnotes
• Light & dark themes: Follows system preference or manual toggle
• Sanitized rendering: All HTML runs through DOMPurify for safe viewing of untrusted markdown
• Small footprint: Native webview (no Electron) with production .dmg under 15 MB

Installation

Currently available via Homebrew (note: app is not signed while waiting for Apple developer review):

brew tap GRVYDEV/tap
brew install --cask GRVYDEV/tap/marky
xattr -cr /Applications/Marky.app

Or build from source (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

Keyboard Shortcuts

• Cmd+K: Command palette (fuzzy file search)
• Cmd+O: Open file
• Cmd+Shift+O: Add folder
• Cmd+F: Search in page

Technical Stack

• Desktop shell: Tauri v2
• Frontend: React + TypeScript + Vite
• Markdown: markdown-it
• UI primitives: shadcn/ui
• Styling: Tailwind CSS
• File watching: notify

Roadmap

The developer plans to add x86 & Linux support (currently macOS ARM only), built-in AI chat for interacting with Claude Code or Codex directly within markdown documents, and git diff review functionality for local code review.