Mermaid Gantt Chart

Gantt charts visualize project timelines, showing tasks, durations, and dependencies. Perfect for planning research phases and tracking progress.

Use Case

Use Gantt charts when you need to:

  • Plan research phases and milestones
  • Visualize project timelines
  • Show task dependencies
  • Track progress over time

Code

 1```mermaid
 2gantt
 3    title Research Project Timeline
 4    dateFormat YYYY-MM-DD
 5    section Phase 1
 6    Literature Review    :done, 2024-01-01, 14d
 7    Hypothesis Formation :active, 2024-01-15, 7d
 8    section Phase 2
 9    Experiment Design    :2024-01-22, 10d
10    Implementation       :2024-02-01, 21d
11```

Result:

Explanation

  • dateFormat - Date format for tasks (YYYY-MM-DD recommended)
  • section - Group related tasks
  • Task format: Name :status, start, duration
  • Status: done, active, crit (critical), or empty
  • Duration: Xd (days), Xw (weeks), or end date

Examples

Example 1: Research Timeline

 1```mermaid
 2gantt
 3    title Research Project Timeline
 4    dateFormat YYYY-MM-DD
 5    
 6    section Discovery
 7    Initial Questions     :done, disc1, 2024-12-01, 3d
 8    Literature Review     :done, disc2, after disc1, 10d
 9    Problem Definition    :done, disc3, after disc2, 5d
10    
11    section Exploration
12    Baseline Implementation :active, exp1, 2024-12-19, 14d
13    Experiments            :exp2, after exp1, 21d
14    Analysis               :exp3, after exp2, 7d
15    
16    section Implementation
17    POC Development        :crit, impl1, 2025-01-20, 28d
18    Testing                :impl2, after impl1, 14d
19    Documentation          :impl3, after impl2, 7d
20```

Result:

Example 2: Milestone-Based

 1```mermaid
 2gantt
 3    title Development Milestones
 4    dateFormat YYYY-MM-DD
 5    
 6    section Setup
 7    Repository Setup      :milestone, 2024-12-01, 0d
 8    Environment Config    :done, 2024-12-01, 2d
 9    
10    section Development
11    Feature A             :done, 2024-12-03, 5d
12    Feature B             :active, 2024-12-08, 7d
13    Feature C             :2024-12-15, 5d
14    
15    section Release
16    Testing               :2024-12-20, 5d
17    Release v1.0          :milestone, 2024-12-25, 0d
18```

Result:

Notes

  • Use milestone for zero-duration events
  • crit highlights critical path tasks
  • Task IDs (like disc1) enable after dependencies
  • Sections help organize related tasks

Gotchas/Warnings

  • ⚠️ Date format: Must match dateFormat exactly
  • ⚠️ Dependencies: Use task IDs with after for dependencies
  • ⚠️ Duration: Can use days (d), weeks (w), or end dates
  • ⚠️ Updates: Remember to update status as project progresses

Related Snippets