CleverCloud

CleverCloud / mdr

Public

a very light rust based markdown reader with support of mermaid (web, native, TUI). vibe coded

355
16
100% credibility
Found Feb 23, 2026 at 68 stars 5x -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Rust
AI Summary

mdr is a lightweight viewer for Markdown files that renders diagrams, tables, and syntax-highlighted code with live reload and options for graphical or terminal display.

How It Works

1
đź“– Discover mdr

You hear about a handy tool that makes reading Markdown files—like reports or notes with drawings—super easy and pretty.

2
đź’ľ Get the viewer

Download the ready-to-use program for your computer—no complicated setup needed.

3
đź“„ Pick your file

Choose a Markdown file you want to read, like a document from your AI helper.

4
✨ See it come alive

The tool instantly shows your file as a beautiful page with diagrams, pictures, and a menu of sections.

5
Choose your view
🪟
Window view

Opens a nice graphical window perfect for detailed reading.

đź’»
Terminal view

Shows everything in your command window, great for quick looks over remote connections.

6
🔍 Find what you need

Search for words, jump to sections, and scroll smoothly.

7
🔄 Watch changes appear

Edit your file or regenerate it, and updates show up right away.

âś… Read effortlessly

You now zoom through complex docs, diagrams, and notes feeling clear and in control.

Sign up to see the full architecture

6 more

Sign Up Free

Star Growth

See how this repo grew from 68 to 355 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 mdr?

mdr is a lightweight Rust binary for viewing Markdown files with native Mermaid diagram rendering—flowcharts, sequences, gits, all as SVG. Run `mdr file.md` for instant previews in egui GUI, webview (GitHub light theme colors), or TUI, with live reload on edits and in-doc search via Ctrl+F or /. It solves squinting at raw terminal text or fiddling with VS Code/browser for AI-generated docs full of diagrams, starting in milliseconds without Node or Electron.

Why is it gaining traction?

Zero-runtime deps, cross-platform binaries via cargo/brew/nix, and auto-backend detection (TUI over SSH, egui elsewhere) beat VS Code extensions or mermaid.live. Live TOC navigation, GFM tables/tasklists, and syntax highlighting feel native, while Mermaid skips JS entirely—fixing light rust removal issues in other tools. Devs dig the github light mode fidelity in webview without light pollution from heavy frameworks.

Who should use this?

AI prompt engineers parsing LLM Markdown reports with diagrams over SSH. DevOps reading remote config docs in TUI without GUI fuss. Rust devs wanting a github light bulb for quick light novel crawler outputs or light rust orange color spec reviews, skipping VSCode's github light theme vscode churn.

Verdict

Solid for daily Markdown+Mermaid reads—great docs, tests, releases—but 16 stars and 1.0% credibility signal early maturity (e.g., some Mermaid shapes unsupported). Try via `nix run github:CleverCloud/mdr`; fork if lumon mdr github vibes hit, or mdr jump in for custom backends.

(187 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.