mdvi is a terminal markdown viewer with Vim-style navigation.

It renders markdown into a polished full-screen TUI with fast keyboard navigation, clear typography, and predictable behavior for large files.

• Full-screen terminal viewer (crossterm + ratatui)
• Vim-style navigation controls
• High-quality markdown rendering via pulldown-cmark
• Support for:
  • headings
  • lists and task lists
  • blockquotes
  • code blocks and inline code
  • links, tables, footnotes, emphasis/strong/strikethrough
• Live reload (r) when the file changes on disk
• Start at specific line (--line)
• Works with standard terminal keys (arrows, page up/down, home/end)

brew tap taf2/tap
brew install mdvi

Examples:

mdvi docs/spec.md
mdvi --line 120 CHANGELOG.md

• j / Down: scroll down one line
• k / Up: scroll up one line
• Ctrl-d: half-page down
• Ctrl-u: half-page up
• PageDown: full-page down
• PageUp: full-page up
• Ctrl-f: full-page down (Vim-style)
• Ctrl-b: full-page up (Vim-style)
• g / Home: jump to top
• G / End: jump to bottom
• r: reload file from disk
• /: start search
• n: next search match
• N: previous search match
• ?: toggle help line
• q: quit

Rust is a strong fit for a serious CLI viewer:

• precise terminal control
• excellent performance for large files
• single static binary distribution
• mature ecosystem for TUI and markdown parsing

cargo test
cargo fmt
cargo clippy -- -D warnings

MIT