Skip to main content
terminal · markdown · pager

mdcat

Render Markdown beautifully in your terminal.
Full colour, syntax highlighting, search, and mouse — zero config.

$npm i -g @dunkinfrunkin/mdcat
mdcat README.md
$

Everything you need

All GitHub-Flavoured Markdown rendered with care. Nothing to configure.

🎨
One Dark palette

Easy on the eyes in any dark terminal. Consistent colors for every Markdown element.

# Heading
**bold** _italic_ `code`
> blockquote
🔍
Incremental search

Press / to search. Matches highlight live with gold gutter markers. n / N to cycle.

Press /  to enter search
Type to filter in real time
n / N  to jump between hits
⌨️
Keyboard-driven

Familiar vi-style bindings. j/k, space/b, g/G — zero learning curve if you know less.

j / k     scroll line
space / b  page down/up
g / G     top / bottom
🖱️
Mouse wheel

Scroll naturally with your mouse wheel. Three lines per tick using SGR mouse mode.

Scroll ↑   offset -= 3
Scroll ↓   offset += 3
🔗
Clickable links

OSC 8 hyperlinks work in iTerm2, Kitty, WezTerm, foot, and Ghostty.

[link text](https://example.com)
→ blue underline, clickable
📦
Zero config

No config files, no env vars, no setup. Pipe or open — it just works.

npx @dunkinfrunkin/mdcat file.md
curl … | npx @dunkinfrunkin/mdcat
$

Open in your browser

Prefer a browser? Use the --web flag to render your Markdown as a styled HTML page and open it instantly.

$mdcat --web README.md
localhost:3000/README.md
mdcat /\(o.o)/\

npmMITnode ≥18

Terminal pager for Markdown. Full colour, syntax highlighting, incremental search, mouse support — zero config.

npm install -g @dunkinfrunkin/mdcat
Install
# Global npm install -g @dunkinfrunkin/mdcat
Usage
mdcat README.md # open a file mdcat --web README.md # render & open in browser
$

Keyboard shortcuts

vi-style bindings. Familiar if you know less or vim.

q
Quit
y
Copy visible page to clipboard
M
Toggle mouse (off = free text selection)
j / k
Scroll down / up one line
/
Scroll up / down one line
Space / b
Page down / page up
d / u
Half-page down / up
g / G
Jump to top / bottom
/
Enter search mode
n / N
Next / previous match
Esc
Cancel search or clear matches
Mouse wheel
Scroll up / down three lines

Try it right now

No install required. Just paste this into your terminal.

$npm i -g @dunkinfrunkin/mdcat