Typora怎么画流程图?Mermaid图表基础用法

在 Markdown 笔记中记录复杂的业务逻辑或程序流程时，纯文字描述往往不够直观。Typora 内置了对 Mermaid 的支持，允许用户通过简单的代码块直接将文本转换为流程图。这种方式无需切换专业绘图软件，且源码即文档，便于后续修改和维护。

Typora 中渲染完成的 Mermaid 流程图示例

Mermaid 的渲染效果依赖于 Typora 的版本及内部配置。建议先从最基础的“开始—判断—结束”结构入手，验证环境支持后，再逐步增加节点复杂度。

1. 插入 Mermaid 代码块

在 Typora 编辑区域输入三个反引号 ```，紧接着输入 mermaid 并回车，即可创建一个专用的代码块。Typora 会识别该标记并尝试渲染其中的内容。

在代码块中输入以下基础示例：

flowchart TD
    A[开始] --> B{资料是否完整}
    B -->|是| C[继续处理]
    B -->|否| D[补齐资料]
    C --> E[结束]
    D --> E

输入完成后，点击代码块外部或切换至预览模式，Typora 会自动将代码转换为图形。如果仍然显示为灰色代码背景，请检查第一行是否严格拼写为 mermaid，并确认当前 Typora 版本已启用 Mermaid 渲染功能。

在 Typora 中输入 mermaid 代码块

2. 理解方向与节点标识

示例首行的 flowchart TD 定义了图表的基本布局：flowchart 表示这是流程图，TD (Top-Down) 表示节点从上到下排列。若需从左到右排列，可改为 LR (Left-Right)。

代码中的 A、B、C 等字母是节点的唯一标识符（ID），用于建立连接关系，不会直接显示在图中。方括号 [] 内的文字才是最终呈现的节点标签。例如 A[开始] 表示 ID 为 A 的节点显示文字“开始”。

修改流程时，建议先只替换方括号内的中文描述，保持 ID 和连接符号不变，确保最小化改动仍能正常渲染。

2. 理解方向与节点标识

3. 设置判断分支与条件

流程图的核心在于决策分支。在 Mermaid 中，大括号 {} 用于定义菱形判断节点。箭头上的竖线包裹文字 |条件| 用于标注分支路径的含义。

例如，要表达“审核通过”与“退回补充”两种结果，可编写如下代码：

flowchart TD
    A[提交申请] --> B{是否通过}
    B -->|通过| C[进入下一步]
    B -->|退回| D[补充材料]

注意分支条件的文字应简练准确。当流程变得复杂时，避免使用过多交叉箭头，可考虑将大图拆分为多个子流程，以保持图表的可读性。

4. 处理特殊字符与调试

节点文字应尽量简短。虽然 Mermaid 支持中文和常见标点，但若节点内容包含括号、引号或换行符，可能会导致解析错误。遇到图表无法显示的情况，可采用“二分法”排查：

1. 回退到上一次能正常渲染的代码版本。
2. 逐行添加新的节点或连接线。
3. 观察哪一行加入后图表消失，从而定位语法错误。

常见错误包括代码块标记未闭合、方向关键字拼写错误（如写成 td 小写）、或连接符 --> 遗漏。

4. 处理特殊字符与调试

5. 验证导出效果

完成绘图后，保存文件并重新打开，确认图表在重启后仍能正确渲染。若需导出为 PDF 或图片，请在导出前检查节点文字是否被截断、箭头是否重叠。

导出前检查节点文字与布局

需要注意的是，编辑器内的实时预览效果与最终导出文件的渲染引擎可能略有差异。对于正式交付的文档，建议同时保留 .md 源文件和导出的静态图片，以便在不同环境中查看或供他人修改源码。

掌握 flowchart 方向定义、节点形状、箭头连接及判断分支这四个核心要素，即可应对大多数日常流程图需求。复杂的样式调整可在基础结构稳定后再逐步尝试。