A mellow terminal markdown viewer. Read .md files comfortably in your terminal.

curl -fsSL https://raw.githubusercontent.com/mw2000/melo/main/install.sh | sh

This downloads the latest release binary to ~/.local/bin. Make sure it's on your PATH:

export PATH="$HOME/.local/bin:$PATH"

just install

Or with cargo directly: cargo install --path . (requires Rust 1.85+).

melo <file>

Pipe from stdin:

cat README.md | melo
curl -s https://example.com/doc.md | melo

Pass --help or --version for the usual.

Choose a color theme with --theme:

melo --theme ocean README.md

Available themes: dark (default), light, ocean.

Create ~/.config/melo/config.toml to set defaults:

theme = "ocean"

CLI flags override config file values.

Mouse scroll is supported.

• Syntax-highlighted code blocks with GitHub-style borders
• Tables with box-drawing characters
• Heading styles (H1 with background, H2-H6 bold + color)
• Inline formatting (bold, italic, strikethrough, inline code)
• Table of contents popup with heading navigation
• Link picker with browser opening
• Relative markdown link following with back navigation
• YAML front matter stripping
• Inline image rendering (PNG, JPEG, GIF) via halfblock encoding
• File watching with auto-reload
• Three built-in color themes
• Configurable via TOML config file

• ratatui 0.30
• crossterm 0.29
• pulldown-cmark 0.13
• syntect 5

MIT