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,)。

gantt         
       dateFormat  YYYY-MM-DD   
       title 使用mermaid语言定制甘特图
       section 任务1
       已完成的任务           :done,    des1, 2014-01-06,2014-01-08
       正在进行的任务               :active,  des2, 2014-01-09, 3d
       待完成任务1               :         des3, after des2, 5d
       待完成任务2              :         des4, after des3, 5d

3、将甘特图转换为PDF或html格式

将甘特图复制至到Typora，导出为需要的格式。

使用Typora导出为PDF、html或图像.png

4、打印甘特图

使用Typora将甘特图导出为html格式
在转换之前可以选择合适的主题进行渲染
使用浏览器打开html格式
使用浏览器打印功能打印

5、附甘特图实例代码

附甘特图实例（需在第一行添加mermaid并以开头，在最后一行添加结尾）。简书的Markdown编辑器会自动将代码第一行及最后一行过滤。

gantt         
       dateFormat  YYYY-MM-DD   
       title 使用mermaid语言定制甘特图

       section 任务1
       已完成的任务           :done,    des1, 2014-01-06,2014-01-08
       正在进行的任务               :active,  des2, 2014-01-09, 3d
       待完成任务1               :         des3, after des2, 5d
       待完成任务2              :         des4, after des3, 5d

       section 关键任务
       已完成的关键任务 :crit, done, 2014-01-06,24h
       已完成的关键任务2         :crit, done, after des1, 2d
       正在进行的关键任务             :crit, active, 3d
       待完成的关键任务        :crit, 5d
       待完成任务           :2d
       待完成任务2                      :1d

       section 文档编写
       描述甘特图语法               :active, a1, after des1, 3d
       完成甘特图实例1      :after a1  , 20h
       完成甘特图实例2    :doc1, after a1  , 48h

END