Skip to content

Timeline

Events along an axis.

Events on a line. Each one is Date: What happened, with any detail indented under it, and a anywhere a line should break; the date is optional, so a plain sequence of steps works too. Events alternate above and below the line, which is not decoration — it is what lets each card be twice as wide, because its nearest neighbour on its own side is two columns away. Seven events fit a portrait page; past that use dir=vertical, which runs down the page and has no limit.

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

@timeline title="Project milestones"
  Q3 2026: Discovery
    Interviews, synthesis, personas
  Oct 2026: Alpha
    Core primitives, extension preview
  Dec 2026: Beta
    Full primitive set, docs
  Q1 2027: Launch
    Marketplace, site, community

Project milestones

Q3 2026

Discovery

Interviews, synthesis, personas

Oct 2026

Alpha

Core primitives, extension preview

Dec 2026

Beta

Full primitive set, docs

Q1 2027

Launch

Marketplace, site, community

Settings
SettingTypeRequiredDefaultMeaning
titlestringno—Title above the timeline.
dirhorizontal · verticalnohorizontalhorizontal draws a line across the page. vertical runs down it — no sides, no scaling, and no limit on how many events.
alternatebooleannotrueAlternate events above and below the line. Turning it off puts everything underneath, and halves how wide each card can be.
More examples
@timeline(dir=vertical)
  Q3 2026: Discovery
    Interviews, synthesis, personas
  Oct 2026: Alpha
    Core primitives, extension preview
  Dec 2026: Beta
  Q1 2027: Launch
  1. Q3 2026

    Discovery

    Interviews, synthesis, personas

  2. Oct 2026

    Alpha

    Core primitives, extension preview

  3. Dec 2026

    Beta

  4. Q1 2027

    Launch