Gantt Chart

Use Mermaid gantt to show work over time, dependencies, milestones, and project scheduling.

Basic template

gantt
    title Sample Plan
    dateFormat  YYYY-MM-DD
    section Work
    Task A :a1, 2026-04-01, 3d

Core syntax

• Start with gantt
• Add title
• Set dateFormat
• Group tasks with section
• Create tasks with:
  • Task :id, start, duration
  • Task :id, after otherId, duration
  • Milestone :milestone, id, date, 0d
• Useful flags:
  • done
  • active
  • crit

Common example

gantt
    title Release Plan
    dateFormat  YYYY-MM-DD

    section Discovery
    Requirements      :done, req, 2026-04-01, 4d
    Design            :done, des, after req, 3d

    section Build
    Implementation    :active, impl, after des, 6d
    Testing           :test, after impl, 3d

    section Release
    Go Live           :milestone, go, 2026-04-18, 0d

Good for

• Delivery plans
• Migration windows
• Project summaries

Watch for

• Mermaid Gantt is strongest for lightweight planning, not full project management
• Use real dates if the audience cares about calendar timing