Markdown繪制甘特圖教程

日常工作中多個項目並行推進時，很難描述清楚每個任務的進度，以及當前狀態。之前也想過用甘特圖來管理項目進度，但是繪制甘特圖的成本太高，而且不容易掌握。很難在團隊中推廣普及。

最近在使用Markdown排版時，發現Markdown可以快速便捷的生成甘特圖，且能滿足日常工作需求。

下面用一個簡單的實例，簡單講解Markdown mermaid甘特圖的繪制與使用。

該教程主要包括以下幾個部分：

1、選擇工具（使用印象筆記或Typora編制甘特圖）
2、mermaid常用關鍵寫說明
3、將甘特圖轉換為PDF或html格式
4、打印甘特圖
5、附甘特圖實例代碼

1、選擇工具

市面上Markdown編輯器不少（比如：MarkdownPad、cmd markdown、有道筆記、簡書、印象筆記、Typora等等），但是支持mermaid語法的很少。

這幾個里邊也就印象筆記、Typora支持甘特圖。下面附上下載鏈接。

Typora
印象筆記

印象筆記支持左側編輯右側實時顯示結果，Typora也可以支持實時顯示結果，但結果與代碼在一個視圖中顯示，不便於查看。

推薦使用印象筆記編制甘特圖，使用Typora渲染甘特圖，導出其它格式。

印象筆記——甘特圖實例.png

2、mermaid關鍵字說明

詳細教程請參照官方教程及示例。

mermaid官方教程

mermaid除了繪制甘特圖之外，還可以繪制流程圖、序列圖、統計圖表等，下面開始對常用關鍵字進行說明。

使用印象筆記中的插入甘特圖按鈕插入一個簡單的甘特圖實例。

一個最簡單的甘特圖

mermaid：圖中紅框第一行內容與最后一行內容，表示當前使用的語言為mermaid。
gantt：表示圖表類型為甘特圖
dateFormat：指定日期格式（Y表示年，M表示月，D表示日）。YYYY-MM-DD（2019-03-14），YY-MM-DD(19-03-14)
section： 項目關鍵字，空格之后輸入項目名稱。
任務行： section后每一行為一個任務。第一個字符串為任務名稱，之后以:開頭，添加任務屬性。

接下來用下面代碼實例說明常見任務屬性。
任務狀態：

• done 已完成
• active正在進行
• crit 關鍵任務
• 默認任務都為待完成狀態

任務描述：在des1、des2位置添加任務描述，其它任務引用時直接引用des1就可以。
after: 描述任務時間關系。des3, after des2表示des3緊跟在des2之后。
任務時長有三種方式：

• 時間范圍 如：2014-01-06,2014-01-08
• 指定天數 如：5d
• 指定開始日期+天數 如：2014-01-06，5d

**PS:所有關鍵字之間用“,”分隔，關鍵字需要屬性時用空格分隔(如：after des2,)。