Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Changelog

Changelog

0.3.0 — 2026-07-21

Added

  • Clickable links in the viewer: a plain mouse click follows the link under the cursor. Local targets (e.g. docs/api.md, resolved against the current document’s directory, %20 escapes decoded) open in the viewer; #anchor fragments — alone or after a file path — jump to the matching heading (GitHub slug rules); destinations with a URI scheme (https:, mailto:, …) open through the OS handler (open / xdg-open / start) without blocking the viewer. Links work everywhere inline content renders — paragraphs, headings, lists, quotes, table cells — and stay clickable when the link text wraps across lines. Print mode output is unchanged.
  • Backspace navigates back to the document a link was followed from, restoring its scroll position. History is kept in memory, so going back works for stdin documents and survives files deleted meanwhile.
  • Mermaid code blocks: the block label gains a view in browser link that opens the diagram rendered in the mermaid.live viewer. The diagram source travels inside the URL fragment, which browsers do not send to any server. Diagrams are not drawn in the terminal (mermaid layout requires a browser engine); see the FAQ for details.

Fixed

  • A viewer whose terminal disappears (terminal emulator crash, orphaned pty) now detects the hangup and exits immediately, instead of running forever at ~25% CPU (a tty EOF is invisible to crossterm 0.28’s event poll; mdpad now watches the tty itself).
  • Termination signals (SIGTERM/SIGHUP/SIGINT/SIGQUIT) quit like q, restoring raw mode, the alternate screen and mouse capture — a kill no longer leaves the shell in raw mode.
  • Browser/URL-opener child processes are reaped instead of lingering as zombies until mdpad exits.

0.2.0 — 2026-07-15

Added

  • Mouse text selection in the viewer: drag to select rendered text; the selection highlights in reverse video, is anchored to document lines (it survives scrolling, and the wheel extends it mid-drag), and is copied to the system clipboard the moment the button is released. Ctrl+C re-copies the current selection and still quits when there is none; Esc or any click dismisses it. Cell mapping is CJK/emoji-aware, and trailing padding is trimmed from copied lines.
  • Clipboard integration through two channels: the native OS clipboard (macOS NSPasteboard, Win32, X11/Wayland) and the OSC 52 escape sequence, so copying works both locally — including terminals without OSC 52 support — and over SSH. See docs/clipboard.md for the terminal support matrix.

Changed

  • The m key still toggles mouse capture; with capture on, dragging now selects inside mdpad instead of doing nothing. Terminal-native selection remains available with capture off (or --no-mouse).
  • Documentation set rebuilt: new user guide (getting started, CLI & keys, selection & clipboard, FAQ, troubleshooting), internals pages with architecture diagrams, contributor/security/conduct policies, and AI-readable llms.txt / llms-full.txt indexes.

0.1.0 — 2026-07-13

Initial release.

  • Markdown rendering engine: semantic block model over pulldown-cmark (CommonMark + GFM tables, strikethrough, task lists, footnotes), tolerant of malformed and adversarial input (depth-capped nesting, no-overflow width invariant, grapheme-safe wrapping).
  • Width-adaptive table layout with staged degradation (protect headers and typical content first, drop padding second, wrap header words third, hard-break giant tokens last), max-min fair column sizing, and a per-row record fallback for tables that cannot fit as a grid.
  • Numeric-column detection: undeclared alignments right-align when ≥ 70% of body cells are numeric.
  • Style-preserving word wrap with correct CJK/emoji display widths and grapheme-safe hard breaks for URLs/identifiers.
  • Syntax highlighting for fenced code blocks (syntect), with 256-color quantization for terminals without truecolor.
  • Interactive viewer: less/vim navigation, incremental smart-case search with match highlighting, table-of-contents jump panel, scrollbar, mouse wheel, resize re-flow, status bar, help overlay.
  • Built-in editor (tui-textarea): undo/redo, atomic Ctrl+S save with instant re-render, dirty-state confirm dialog; E opens $VISUAL/$EDITOR and reloads on exit. CRLF endings, missing final newlines and UTF-8 BOMs round-trip byte-identical.
  • Print mode for pipes/scripts (--print, auto-detected on redirected stdout) with --color auto|always|never and NO_COLOR support.
  • Themes: dark (default), light, plain; --ascii glyph set for terminals without box-drawing fonts.
  • Terminal safety: panic hook restores the terminal state so a crash never leaves the shell in raw mode.
  • Release automation: prebuilt binaries for Linux (x86_64/aarch64, static musl), macOS (Intel/Apple Silicon) and Windows, with SHA-256 checksums; published to crates.io.