Skip to content

Tables

Rows and columns without pipes. Markdown pipe tables still parse, so pasted files work.

A table. No pipes: first row is the header, rows are comma-separated (quote cells that contain commas). Use the record form for few rows with rich cells. Pipe-tables still parse for paste-in compatibility. A table is the one figure that is never scaled — its cells are text, so it widens and then wraps, and the type stays the size of the prose around it. A cell that needs two lines takes a where the break goes, since a row is one line of source.

A block written inside it is drawn below it. What goes inside what

@table
  Feature, Status, Owner
  Search, Shipped, Ana
  Export, In progress, Ben
FeatureStatusOwner
SearchShippedAna
ExportIn progressBen
Settings
SettingTypeRequiredDefaultMeaning
styleruled · sketch · plainnoruledHow the table is lined. ruled sets it on the page’s own ruling, so the paper draws the rows; sketch draws its own grid and clears the ruling behind it; plain is alignment and nothing else — no header either, so the first line is an ordinary row.
sepcomma · tabnocommaCell delimiter for compact rows.
alignstringno—Per-column alignment, e.g. “left,left,right”. A column of nothing but figures is right-aligned on its own.
More examples
@table
  - Feature: Search
    Status: Shipped
    Owner: Ana
  - Feature: Export
    Status: In progress
    Owner: Ben
FeatureStatusOwner
SearchShippedAna
ExportIn progressBen
@table(style=sketch) Q4 status
  Area, Owner, Confidence
  Search, Ana, 0.8
  Export, Ben, 0.4

Q4 status

AreaOwnerConfidence
SearchAna0.8
ExportBen0.4