Real Markdown, right in your terminal
mddog-demo.mp4
Other terminal viewers render Markdown with only characters. Code editors render the real page but live outside the terminal. mddog renders the real page in your terminal, using a single binary without browser nor Electron.
| mddog | Text-based terminal viewers | Code editor preview | |
|---|---|---|---|
| Stays in the terminal | ✅ | ✅ | 🚫 |
| Real fonts and heading sizes | ✅ | 🚫 | ✅ |
| Diagrams and math drawn as graphics | ✅ | 🚫 | Some |
| Images | ✅ | Some | ✅ |
| Live reload | ✅ | Some | ✅ |
| Preview pane in Claude Code | ✅ | 🚫 | 🚫 |
Compared in November 2026 to terminal viewers like glow, leaf, mdcat, Frogmouth, and rich-cli, and to the built-in Markdown previews in VS Code, Cursor, Zed, and JetBrains IDEs.
brew install qu8n/tap/mddogOr, without Homebrew:
curl -fsSL https://raw.githubusercontent.com/qu8n/mddog/main/install.sh | sh- macOS
- A terminal that supports the kitty graphics protocol: Ghostty, iTerm2, kitty, WezTerm, or Rex
mdd # list Markdown files in the current directory to pick from
mdd README.md # preview a fileRead the full docs at mddog.pages.dev/docs for key bindings, Claude Code plugin, configuration, themes, and more.
The logo was made by Helen Nguyen (@daymelon), commissioned for mddog and not covered by the MIT license.