mdx-cli 0.1.4

A fast, beautiful terminal markdown viewer with gradient headings, syntax highlighting, and 8 themes
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50

<p align="center">
  <h1 align="center">mdx</h1>
  <p align="center">A fast, beautiful terminal markdown viewer.</p>
</p>

<p align="center">
  <a href="https://github.com/gowcar/mdx/releases"><img src="https://img.shields.io/github/v/release/gowcar/mdx?style=flat-square&color=bd93f9" alt="Release"></a>
  <a href="https://crates.io/crates/mdx-cli"><img src="https://img.shields.io/crates/v/mdx-cli?style=flat-square&color=ff79c6" alt="Crates.io"></a>
  <a href="https://github.com/gowcar/mdx/blob/main/LICENSE"><img src="https://img.shields.io/github/license/gowcar/mdx?style=flat-square&color=50fa7b" alt="License"></a>
</p>

<p align="center">
  <img src="demo.gif" alt="mdx demo" width="720">
</p>

## Install

```bash
# 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

```bash
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 keybindings** — `j/k`, `gg/G`, `/` search, `n/N` navigate
- **Mouse support** — scroll, drag-select, copy (works in tmux)
- **Hot reload** — edit your file, mdx updates instantly

See [User Guide](docs/user-guide.md) for more details.

## License

[MIT](LICENSE)