Markdown timeline maker

Lay out events on a timeline. Write each date and milestone in Mermaid to show a history, a roadmap or a release schedule at a glance.

Mermaid timeline syntax

A timeline is a title and a list of time periods, each with one or more events. You write the period, a colon and the events. Here is each piece you can write.

Periods and events

Write a period, a colon, then the event text. Reuse a colon to add more events to the same period.

You write

timeline
  title Company history
  2019 : Founded
  2021 : Series A : First office
  2023 : Global launch

You get

Sections

Group periods under a section heading.

You write

timeline
  title Product roadmap
  section 2024
    Q1 : Research
    Q2 : Beta release
  section 2025
    Q1 : Public launch

You get

Cheat sheet

Write this	You get
`timeline`	Start a timeline
`title Text`	Timeline title
`2024 : Event`	A period with one event
`2024 : A : B`	A period with several events
`section Name`	Group the periods that follow