logo

mdserve - markdown preview done right in Rust

74 points thedirtyhand 15 comments
View on Reddit ↗ External link ↗

Been working on mdserve (now at v0.3.0) - a markdown preview server that ships as a single static binary. Wanted something that didn't need Node.js/Python runtimes when it could just be one executable, so built this in Rust with Axum.

Key bits:

  • Single static binary, no runtime deps
  • WebSocket live reload that's actually instant
  • Built-in theme selector (including Catppuccin variants)
  • Full GFM + Mermaid diagram support
  • Stupidly simple: mdserve file.md and you're done

Startup and reload feel instant, and memory usage is extremely low even with large files.

Available via brew tap jfernandez/mdserve && brew install mdserve, Linux install script, or cargo install mdserve.

Repo: https://github.com/jfernandez/mdserve