md-slides

---
name: md-slides
description: Use when converting markdown decks with slide boundaries into HTML presentations with keyboard navigation and presenter mode.
category: Formatting
version: 1.0.0
tools: []
---

# md-review — Code Review Markdown to HTML

Convert markdown PR writeups with diff blocks and severity callouts into a single-file 2-column HTML review. Unified-diff on the left, severity-tagged annotation cards on the right, top jump-nav listing every finding, named reviewer footer.

Three stdlib tools pipeline together: diff parser (md → diff hunks JSON) → annotation extractor (md → severity-tagged annotations) → review HTML renderer (hunks + annotations + tokens → 2-col HTML).

## What Gets Rendered

- **Top jump-nav** — every annotation with severity badge + 80-char preview + jump link; severity counts in heading ("3 BLOCKER · 2 MAJOR · 1 NIT")
- **2-column hunk rows** — unified diff on left (old/new line numbers, +/− marks, tint backgrounds), annotation cards on right (color + icon + aria-label per WCAG 1.4.1)
- **Approval bar** — if `LGTM` markers present and no severity annotations, a success-tinted "LGTM — no findings flagged" bar
- **General comments** — annotations not attached to any hunk render at bottom
- **Reviewer footer** — mandatory; refuses without `--reviewer`
- **Responsive** — 2-col collapses to stacked on viewports < 900px

## Hard Rules

1. **`--reviewer` is mandatory.** A code review must name a human reviewer. Refuses with exit 3 otherwise. Mirrors research-ops's "named owner" discipline.
2. **Refuses if no hunks present.** No `--- a/file` + `@@ ... @@` blocks means this isn't a code review — refuses with exit 4 and recommends `md-document`.
3. **Refuses input < 100 lines.** Markdown wins below the threshold.
4. **Refuses without design-system onboarding.** Same gate as every converter.
5. **Severity is never color-only.** Each badge ships color + icon + `aria-label` + text. WCAG 1.4.1 enforced at the renderer level for accessibility.
6. **Single-file output.** All CSS inline. Only external is Google Fonts CSS. No Prism (diff coloring conflicts with syntax highlighting).
7. **Custom severity convention.** `--severity-convention "critical,important,suggestion,nit"` swaps tier names; position 0 is most severe. Default is BLOCKER / MAJOR / MINOR / NIT (Google Code Review Developer Guide).

## Severity Levels

Default convention: BLOCKER (most severe), MAJOR, MINOR, NIT. Each gets color, icon, and aria-label per WCAG 1.4.1.

## Distinct From

- **`md-document`** — renders prose + tables + code + callouts instead of diff hunks
- **`md-slides`** — renders N discrete slides instead of a single-page artifact
- **GitHub PR comments** — those are a thread; this is a single-author snapshot artifact

## Output Artifact

Single `.html` file with 12 derived CSS custom properties, Google Fonts, all behavior inline, and named reviewer footer.