Markset
Examples
Complete documents, not fragments. Each one is a real .md file in the repository, parsed and rendered for this site by the same packages the command line uses.
Each one is read with a theme stylesheet of its own, and none of them names a color or a width in its source. Everything categorical — a status chip, a tinted pipeline stage, an alert banner, a drawing sheet — is an author class that the theme interprets. That is what keeps a document portable: paste it anywhere and it still reads, because a renderer that has never seen those classes simply ignores them.
Start here
Vocabulary tour
Every construct at the size it would really be used, each carrying a tab that holds the exact source which produced it. It names no theme of its own, so it shows the vocabulary on whatever stylesheet renders it.
Every construct · no theme · source
Seven complete documents
Every company, system and number in these is invented.
Analysis document
A long analysis whose source names no colors and no widths. The status chips, the layer rail and the tinted pipeline stage are all author classes that a theme stylesheet interprets, which is what keeps the document portable.
Analysis · theme dossier.css · source
Strategy memo
An argued memo in a newspaper register: a masthead, a captioned data table, marked sections in a two-lane grid, pull quotes and source citations.
Memo · theme memo.css · source
On-call runbook
The shortest and densest genre there is, read under time pressure, so it opens the way the alert did: a banner with what fired beside the title. Then triage steps that rank themselves, a symptom grid, procedures in tabs and an escalation table.
Runbook · theme runbook.css · source
Architecture overview
The genre that is mostly diagrams, opening on a drawing sheet with its title block. A system map, a state machine and a deployment topology, each an ASCII fence in the source rather than an image file kept in step by hand — and one fence deliberately left as code.
Architecture · theme tidewater.css · source
Capacity review
The genre that argues from quantities, opening on the one chart the case rests on with its table beside it, then a fleet strip and the tables that carry the rest. Written to find out what a document wants when the numbers are the argument.
Data readout · theme cistern.css · source
Service dashboard
A weekly service review whose page is a board of panels rather than a column of prose: a masthead in columns, the week's numbers, a grid of services whose status is the tone of a badge, and three charts drawn from their tables, each panel the same height as its neighbour.
Dashboard · theme console.css · source
Slide deck
A team demo in eleven slides, with no slide construct: each slide is a card carrying .slide, its speaker notes are a folded callout beneath it, and its screenshots are captioned figures. The theme frames every slide at 16:9, pages with scroll snapping and prints one slide to a page; on a phone the frames let go and it reads as a document.
Presentation · theme lectern.css · source