Skip to content
qu8nPublic

About

Real Markdown, right in your terminal

Resources

Contributing

Stars

36 stars

Watchers

0 watching

Forks

Repository files navigation

Logo
mddog

Latest release License Platform: macOS Built with Rust

Real Markdown, right in your terminal

mddog-demo.mp4

Why mddog?

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.

Install

brew install qu8n/tap/mddog

Or, without Homebrew:

curl -fsSL https://raw.githubusercontent.com/qu8n/mddog/main/install.sh | sh

Requirements

Usage

mdd             # list Markdown files in the current directory to pick from
mdd README.md   # preview a file

Docs

Read the full docs at mddog.pages.dev/docs for key bindings, Claude Code plugin, configuration, themes, and more.

Credits

The logo was made by Helen Nguyen (@daymelon), commissioned for mddog and not covered by the MIT license.

About

Real Markdown, right in your terminal

Resources

Contributing

Stars

36 stars

Watchers

0 watching

Forks

Releases

Contributors

Languages