【markdown】介绍如何在markdown中绘制流程图

在 Markdown 中编写流程图主要通过 ​​Mermaid 语法​​实现(多数平台如 GitHub、VS Code、Typora 已原生支持)。以下是详细方法:

1. 基础流程图​

语法结构

用 ```` ```mermaid` 包裹代码块,指定方向后定义节点和连接线:

复制代码
```mermaid
graph 方向
  节点定义
  节点连线
```
方向类型
  • LR:从左到右(默认)
  • TDTB:从上到下
  • RL:从右到左
  • BT:从下到上
示例

对应代码:

复制代码
```mermaid
graph LR
  A[开始] --> B{条件判断}
  B -->|是| C[执行操作]
  B -->|否| D[结束]
```

2. 节点类型​

基本节点
  • ​矩形​[文本]
  • ​圆角矩形​(文本)
  • ​菱形(条件判断)​{文本}
  • ​圆形​((文本))
示例

对应代码:

复制代码
```mermaid
graph TD
  A[矩形节点]
  B(圆角节点)
  C{菱形节点}
  D((圆形节点))
  A --> B --> C --> D
```

3. 连接线样式​

箭头类型
  • 实线:-->
  • 虚线:-.->
  • 加粗线:==>
  • 无箭头线:---
添加文字

在线条中间或右侧添加描述:

对应代码:

复制代码
```mermaid
graph LR
  A -->|描述文字| B
  B -.->|虚线描述| C
  C ==> D
```

4. 子流程图​

subgraph 定义子流程,适合复杂流程拆分:

对应代码:

复制代码
```mermaid
graph TB
  main[主流程]
  subgraph 子流程模块
    A[子步骤1]
    B[子步骤2]
  end
  main --> 子流程模块
  B --> C[后续步骤]
```

5. 高级用法​

节点样式自定义

通过 style 修改颜色、边框等:

对应代码:

复制代码
```mermaid
graph LR
  A[默认样式]
  B[红色背景]:::red
  C[绿色边框]:::green

  classDef red fill:#ff9999,stroke:#333;
  classDef green stroke:#00cc00,stroke-width:2px;
```
注释

%% 添加注释(不会渲染):

对应代码:

复制代码
graph LR
  A --> B
  %% 这是一条注释
  B --> C

6. 工具与调试​

支持平台
  • ​GitHub/GitLab​:需启用 Mermaid 支持(部分平台需插件)。
  • ​VS Code​:安装 Mermaid 插件
  • 实时预览。
  • ​Typora​:原生支持,可直接编辑。
在线编辑器
  • Mermaid Live Editor
  • Draw.io
  • (导出为图片后插入 Markdown)

注意事项​

  1. ​缩进​:节点和子流程需统一缩进(2空格或 4空格)。
  2. ​兼容性​:确保目标平台支持 Mermaid(如不支持,可用工具生成图片后插入)。
  3. ​简化逻辑​:避免过多嵌套,保持流程图简洁。
相关推荐
做科研的周师兄2 天前
【机器学习入门】8.2 主成分分析:一文吃透主成分分析(PCA)—— 从原理到核心逻辑
人工智能·算法·决策树·机器学习·流程图
siaikin3 天前
基于 Astro Starlight 的多框架文档
前端·vue.js·markdown
深海的鲸同学 luvi4 天前
【HarmonyOS】原生 Markdown 渲染解决方案 —— @luvi/lv-markdown-in
华为·harmonyos·markdown·原生渲染
做科研的周师兄6 天前
【机器学习入门】7.1 决策树 —— 像 “判断流程图” 一样做分类
决策树·机器学习·流程图
东风西巷7 天前
draw.io(免费流程图制作工具) 中文绿色版
学习·电脑·流程图·软件需求·draw.io
secondyoung14 天前
Markdown转换为Word:Pandoc模板使用指南
开发语言·经验分享·笔记·c#·编辑器·word·markdown
Source.Liu15 天前
【mdBook】6 在持续集成中运行 mdbook
markdown
Source.Liu16 天前
【mdBook】5.5 mdBook 特色功能
markdown
Source.Liu18 天前
【mdBook】7.1 预处理器
markdown
Source.Liu19 天前
【mdBook】5.2.3 渲染器配置详解
markdown