mdserve is a fast, lightweight markdown preview server I created for terminal-based workflows.

Read more about it in my blog post.

Key Features

  • Zero dependencies: Just a single binary
  • Lightning fast: Built in Rust
  • Live reload: Auto-refreshes when files change
  • Beautiful themes: Built-in Catppuccin support (Latte, Macchiato, Mocha) plus additional themes

Installation

macOS:

brew install mdserve

Linux:

curl -sSfL https://raw.githubusercontent.com/jfernandez/mdserve/main/install.sh | bash

Cargo:

cargo install mdserve

Usage

mdserve README.md

The server starts up and provides a local URL to view your rendered markdown. Use the 🎨 button to switch between themes.