Marky 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. View Demo • Install • Request Features Table of Contents About The Project Features Install Homebrew From Source Usage Keyboard Shortcuts Development Built With Roadmap Contributing Contact Me About The Project 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. Features 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. Install Homebrew 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 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 The install script symlinks marky to ~/.local/bin/ . Make sure that's on your PATH : # bash/zsh export PATH= " $HOME /.local/bin: $PATH " # fish set -Ux fish_user_paths $HOME /.local/bin $fish_user_paths Usage # Open a single file marky README.md # Open a folder as a workspace marky ./docs/ # Open with no args — restores your last session marky Keyboard Shortcuts Shortcut Action Cmd+K Command palette (fuzzy file search) Cmd+O Open file Cmd+Shift+O Add folder Cmd+F Search in page Development pnpm install pnpm tauri dev # dev server with HMR Run Tests # Frontend pnpm test # Rust cd src-tauri && cargo test Project Structure src-tauri/ Rust backend — CLI, file I/O, file watching, folder registry, fuzzy search src/ React frontend — markdown pipeline, UI components, theme src/components/ App components (Viewer, Sidebar, CommandPalette, etc.) src/components/ui/ shadcn/ui primitives src/lib/ Core logic (markdown-it config, Shiki, Tauri IPC wrappers) src/styles/ Tailwind base + markdown prose styles scripts/ Install helpers Built With Layer Tech Desktop shell Tauri v2 Frontend React + TypeScript + Vite Markdown markdown-it Syntax highlighting Shiki Math KaTeX Diagrams Mermaid Fuzzy search nucleo UI primitives shadcn/ui Styling Tailwind CSS File watching notify 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 Contributing Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated . Fork the Project Create your Feature Branch: git checkout -b feature/AmazingFeature Commit your Changes: git commit -m 'Add some AmazingFeature' Push to the Branch: git push origin feature/AmazingFeature Open a Pull Request Before submitting a PR: Run pnpm test and cd src-tauri && cargo test Run pnpm typecheck Actually open a markdown file with pnpm tauri dev and verify it renders correctly Contact Me GitHub @GRVYDEV · Twitter @grvydev