mdpad
A fast, beautiful markdown reader and editor for the terminal.
less and more show markdown as raw markup: headers drown in #s, nested
bullets collapse, and tables become pipe soup. mdpad renders the document
properly — styled headings, aligned tables that adapt to your terminal width,
syntax-highlighted code, nested lists and quotes — and lets you select text,
copy it, and edit the file without leaving the viewer.
Why mdpad
- Tables that actually work. Column widths adapt to the terminal using a staged layout algorithm: typical content and headers are protected first, and only the space-hungry columns wrap. A 10-column benchmark table stays readable at 80 columns; tables that cannot physically fit as a grid degrade to a clean per-row record view instead of overflowing.
- Numeric columns auto right-align, the way a human would lay them out.
- Select and copy with the mouse. Drag to select rendered text; it lands on your system clipboard the moment you release the button — locally and over SSH.
- Full navigation: vim/less keys, incremental search with highlighting, a table-of-contents jump panel, scrollbar, mouse wheel.
- Links you can follow. Click a link: local markdown files open in the
viewer (
Backspacegoes back),#anchorsjump to their heading, and external URLs open in your browser. Mermaid blocks carry a one-clickview in browserlink to the rendered diagram. - Editing built in: a built-in editor with atomic saves and instant
re-render, or hand off to your
$EDITOR. - Behaves in pipes: pipe to
grepand get clean text;--printrenders ANSI for terminals; respectsNO_COLOR. - Single static binary. No runtime, no config files, instant startup. Works on Linux, macOS and Windows.
Quick start
mdpad README.md # interactive viewer
mdpad --print README.md # render to stdout
curl -s https://example.com/doc.md | mdpad
Press ? inside the viewer for the complete key reference, q to quit.
Continue with Getting started, or jump straight to CLI & keys for the full reference and Selection & clipboard for how copying works.