Components Comparison
compare-table
Comparison Ledger Prose
Multi-row comparison table with consistent columns.
Use when you have 3+ options or 4+ rows of criteria. Wider data than compare-prose can hold legibly.
When to use
- Wider than compare-prose. Three or more options, or four or more rows of criteria. compare-prose maxes out at two columns and short bodies; compare-table scales further.
- Cells are short phrases. Each cell is a value, a phrase, or a state marker — not a paragraph. If the cells need sentences, use
verdict-gridorcards-stack. - Stable column meaning. Every row reads the same way across columns. Mixing column meanings row-to-row breaks the table's scannability.
When not to use
- Cells full of prose. Long sentences in a table cell wrap awkwardly and force the column wider. Move to
verdict-gridfor criteria with body text, orcards-stackfor full prose rows. - More than 6 rows. Past 6 rows the table density crowds the slide. Split into two slides or summarise the rows that don't differentiate.
- State-marker rows. When most cells are pass/fail/partial badges, the right layout is
obligation-matrixorverdict-grid. compare-table is for textual values.
Slots
| Slot | Selector | Required | Description |
|---|---|---|---|
title | h2 | yes | Slide heading framing the comparison. |
table | table | yes | Markdown table with header row and 2+ data rows. |
Anatomy
┌─────────────────────────────────────────┐
│ header │
│ LABEL │
│ Here are the numbers side by side. │
│ │
│ ┌───────────┬───────────┬───────────┐ │
│ │ │ Option A │ Option B │ │
│ ├───────────┼───────────┼───────────┤ │
│ │ Row 1 │ ✓ │ ✕ │ │
│ │ Row 2 │ ✕ │ ✓ │ │
│ │ Row 3 │ ✓ │ ✓ │ │
│ │ Row 4 │ ⚠ │ ✓ │ │
│ └───────────┴───────────┴───────────┘ │
│ Footnote text for scope caveats. │
│ footer 11/19 │
└─────────────────────────────────────────┘