🕰️ Mermaid

Timeline

Tell a story year by year

Open this example in the editor Generate one with AI

What is a Timeline?

A timeline lays events chronologically: company history, project milestones, product evolution, incident retrospectives. Mermaid timelines group multiple events per period and stay readable at any size.

Live example

Mermaid code

timeline
    title History of the project
    2024 : Idea & prototype
    2025 : First customers
         : Seed funding
    2026 : EU expansion
         : AI features

Live example

When to use it

Present company or product history

Document incident timelines for postmortems

Show roadmap milestones by quarter or year

Basic syntax

.mmd

timeline
    title My timeline
    2025 : Event A
         : Event B
    2026 : Event C

Questions about this diagram

Can one period contain several events?

Yes — add extra lines starting with “:” under the same period and they stack vertically under that date.

Timeline or Gantt chart?

Timeline for past or high-level storytelling (events at dates). Gantt for planning work (tasks with durations and dependencies).

Explore other diagram types

🔀 Flowchart 💬 Sequence diagram 🧩 Class diagram 🗄️ Entity-relationship diagram 🔄 State diagram 📅 Gantt chart 🥧 Pie chart 🧠 Mind map 🌿 Git graph 🚶 User journey 🎯 Quadrant chart

Create your Timeline now

Describe it in plain language — the AI writes the Mermaid code for you.

Open Mermaid Studio