taf2

taf2 / mdvi

Public

cli based Markdown viewer

264
12
100% credibility
Found Feb 10, 2026 at 70 stars 4x -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Rust
AI Summary

mdvi is a full-screen terminal viewer for Markdown files that offers polished rendering and Vim-inspired keyboard navigation including search and live reload.

How It Works

1
👀 Discover mdvi

You hear about mdvi, a cozy full-screen viewer that makes reading markdown files in your terminal feel smooth and polished.

2
💻 Get it ready

You quickly add mdvi to your computer so it's all set to use.

3
📄 Open a file

You pick any markdown file, like notes or docs, and start the viewer – it fills your screen instantly.

4
🌟 See it shine

Your file transforms into beautiful text with clear headings, neat lists, code blocks, and links – easy on the eyes.

5
🔍 Explore freely

Scroll with up/down arrows or j/k keys, search with /, jump to top/bottom, and refresh if the file updates.

6
Help anytime

Toggle the help guide to see all controls, making navigation feel natural and fun.

Read like a pro

You effortlessly browse long documents, finding what you need quickly and enjoying every moment.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 70 to 264 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is mdvi?

mdvi is a Rust CLI Markdown viewer that renders docs full-screen in your terminal using crossterm and ratatui for a smooth TUI experience. It parses Markdown into readable text with syntax-highlighted code blocks, tables, images (local, file://, or HTTP via reqwest), and footnotes, plus Vim-style keys for scrolling, search, and jumping lines. Fire it up with `mdvi README.md --line 42 --image-protocol kitty` for instant CLI Markdown preview on Linux, Ubuntu, Windows, or mac.

Why is it gaining traction?

Vim navigation (j/k, Ctrl-f/b, / search) plus live reload (r key) beats basic pagers like less or glow for navigating large GitHub repos. Configurable image protocols (halfblocks, sixel, kitty, iterm2) handle inline pics without macOS dialogs, and syntax highlighting via syntect shines on code-heavy Markdown. Single static binary from Cargo means zero deps for quick CLI GitHub manual checks or previews before push.

Who should use this?

Terminal diehards reviewing CLI GitHub repos or changelogs on Ubuntu/Linux workstations. DevOps folks needing a fast md viewer for Markdown specs without browser context-switching. Rust or CLI GitHub Copilot users wanting local Markdown reader/renderer over VS Code previews.

Verdict

At 18 stars and 1.0% credibility, mdvi feels early-stage but delivers with crisp docs, Cargo/Homebrew installs, and solid tests—try it for lightweight CLI Markdown viewing. Skip if you need PDF export; otherwise, it's a sharp niche tool worth cargo install.

(178 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.