All GitHub-Flavoured Markdown rendered with care. Nothing to configure.
Auto-detects your terminal background. One Dark for dark terminals, One Light for light ones. Override with --light or --dark.
mdcat README.md # auto mdcat --light README.md # force MDCAT_THEME=dark mdcat …
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
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
Scroll naturally with your mouse wheel. Three lines per tick using SGR mouse mode.
Scroll ↑ offset -= 3 Scroll ↓ offset += 3
OSC 8 hyperlinks work in iTerm2, Kitty, WezTerm, foot, and Ghostty.
[link text](https://example.com) → blue underline, clickable
Use -p / --plain to strip all ANSI styling and skip the TUI. Perfect for piping to grep, pbcopy, or other tools.
mdcat -p README.md | grep install mdcat --plain NOTES.md | pbcopy
See which lines changed at a glance. Green + for added, yellow ~ for modified, red - for deleted. Works automatically in git repos.
+ added line ~ modified line - deleted line
No config files, no env vars, no setup. Pipe or open — it just works.
npx @dunkinfrunkin/mdcat file.md curl … | npx @dunkinfrunkin/mdcat
Prefer a browser? Use the --web flag to render your Markdown as a styled HTML page and open it instantly.
mdcat --web README.mdnpmMITnode ≥18
Terminal pager for Markdown. Full colour, syntax highlighting, incremental search, mouse support — zero config.
vi-style bindings. Familiar if you know less or vim.
No install required. Just paste this into your terminal.
npm i -g @dunkinfrunkin/mdcatbrew install dunkinfrunkin/tap/mdcat