mdx-cli 0.1.6

A fast, beautiful terminal markdown viewer with gradient headings, syntax highlighting, and 8 themes
mdx-cli-0.1.6 is not a library.

Install

# Homebrew
brew install gowcar/tap/mdx

# Cargo
cargo install mdx-cli

# One-line install (macOS & Linux)
curl -fsSL https://raw.githubusercontent.com/gowcar/mdx/main/install.sh | sh

Usage

mdx README.md

Features

  • Instant launch — native Rust, starts in milliseconds
  • 8 built-in themes — Dracula, Catppuccin, Nord, Tokyo Night, and more. Press t to cycle
  • Custom themes — fully configurable via ~/.config/mdx/config.toml
  • Syntax highlighting — 100+ languages
  • Smart tables — auto-resize columns, Unicode-aware alignment
  • Vim keybindingsj/k, gg/G, / search, n/N navigate
  • Mouse support — scroll, drag-select, copy (works in tmux)
  • Hot reload — edit your file, mdx updates instantly
  • Yazi integration — one-command setup as yazi's markdown previewer

See User Guide for more details.

Yazi Preview

Use mdx to render markdown in yazi's preview pane:

mdx --setup-yazi

This installs the mdx previewer plugin and configures yazi automatically. Navigate to any .md file in yazi to see it in action.

License

MIT