catmd

cat for Markdown — render .md files in the terminal with colors, underlined headings, tables, and clickable links.

Inspired by the pi coding agent’s markdown display.

Usage

catmd README.md
catmd notes.md docs/guide.md
echo "# Hello" | catmd

Options:

• --no-color — plain output
• --no-hyperlinks — no OSC 8 terminal links
• --theme PATH — custom theme.json (default: bundled theme; override with CATMD_THEME)

Try the showcase file:

catmd EXAMPLE.md

Install with Homebrew

Installed from GitHub via PlebeiusGaragicus/tap. No npm package registry.

brew tap PlebeiusGaragicus/tap
brew install catmd

Update:

brew update
brew upgrade catmd

Requires Homebrew and Node.js 22+ (installed automatically by the formula).

Developing

See AGENTS.md for releases (git tags + tap formula) and how to verify with brew upgrade catmd.

Version

Current release: 0.1.0 — see VERSION and tags.