Marky: A Lightweight Markdown Viewer for Agent-Generated Documentation

✍️ OpenClawRadar📅 Published: April 18, 2026🔗 Source
Marky: A Lightweight Markdown Viewer for Agent-Generated Documentation
Ad

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
Ad

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.

📖 Read the full source: HN AI Agents

Ad

👀 See Also