#git 分支图（Mermaid 围栏）

#这是什么

和git 分支图画的是同一种图，区别只在怎么写：这一页用 ```mermaid 围栏，直接写 Mermaid 自己的图源。

#什么时候用

• 源文档要发到 GitHub，并且希望在 GitHub 上也能看到图——自有写法在那边显示成一段普通文字
• 已经会 Mermaid，不想再学一套
• 需要自有写法表达不了的细节（下面「坑」那一节写明是哪些）

其余情况用自有写法：字段名固定，写错了当场报错并指到具体那一行。

#怎么写

```mermaid
gitGraph
  commit id: "初始"
  branch themes
  commit id: "十三套主题"
  checkout main
  merge themes
```

#出来是什么样

编译时就画成 SVG 内联进产物，读者那边不下载任何绘图库、也不联网。颜色跟着主题走，可以滚轮缩放、按住拖动、双击复位。

#坑

• branch 拉分支，checkout 切回去，merge 合并
• id: 里的字符串要加引号
• 提交超过十个就挤成一条线，只画关键的几个