> ## Documentation Index
> Fetch the complete documentation index at: https://help.dingtalk.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 插入文本绘图说明

> 钉钉文档文本绘图功能：通过 PlantUML 或 Mermaid 语法快速生成流程图、时序图等图表，支持实时预览，适合需要以代码方式维护可编辑图示的场景。

文本绘图是钉钉文档提供的一种语法绘图，通过一些特定的语法快速绘制出你需要的流程图、甘特图等。目前支持：

* **PlantUML**

* **Mermaid**

## 一、插入方式

点击工具栏插入图标 或者 空行行首+号按钮 选择文本绘图，或 输入“/文本绘图” 或者 “/wbht” 快捷键方式插入，支持中文，拼音。

<img src="https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/AmPdnpgVpyrblw98/img/ab7b194e-e11f-48f3-9916-9e2211911c10.png" referrerPolicy="no-referrer" alt="image.png" />

上方工具栏插入

<img src="https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/AmPdnpgVpyrblw98/img/20c7c030-677f-48a8-b2d6-49975964e9da.png" referrerPolicy="no-referrer" alt="image.png" />

空白行顶端【+】插入

<img src="https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/AmPdnpgVpyrblw98/img/eed398c2-48dd-41da-87b0-0ddc831e314c.png" referrerPolicy="no-referrer" alt="image.png" />

“/wbht”插入

<img src="https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/AmPdnpgVpyrblw98/img/deb84aaf-2fc6-409c-968b-e5208c571f85.png" referrerPolicy="no-referrer" alt="image.png" />

“/文本绘图”插入

## 二、使用指南

## 实时预览：

在插入的输入框里选择你需要的语法和模板，在左侧输入语法，在右侧可实时预览。

<img src="https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/AmPdnpgVpyrblw98/img/be295c35-d63b-4d7e-be0e-4b8d22e208f6.png" referrerPolicy="no-referrer" alt="image.png" />

<img src="https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/AmPdnpgVpyrblw98/img/165a85f6-bffd-4bf6-ac88-1172dc21ecd4.png" referrerPolicy="no-referrer" alt="image.png" />

## 全卡片展示绘图：

点击中间的推拉按钮，即可全卡片展示绘图

<img src="https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/AmPdnpgVpyrblw98/img/cc2ca1e0-842c-4fa1-a06c-ae10ea9a8439.png" referrerPolicy="no-referrer" alt="image.png" />

<img src="https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/AmPdnpgVpyrblw98/img/8d6a8166-9471-4a8b-8712-c5b526f87c26.png" referrerPolicy="no-referrer" alt="image.png" />

## 全屏展示：

点击右上角全屏按钮，即可全屏浏览

<img src="https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/AmPdnpgVpyrblw98/img/727dda5a-22c6-4a9a-8031-e2c5cca87439.png" referrerPolicy="no-referrer" alt="image.png" />

<img src="https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/AmPdnpgVpyrblw98/img/0d9e4bf6-474a-4e00-8a99-e909ccd35ab3.png" referrerPolicy="no-referrer" alt="image.png" />

***

## PlantUML

[PlantUML](http://plantuml.com/)是一个开源项目，支持快速绘制时序图、用例图、类图、活动图、组件图、状态图、对象图、部署图等。同时还支持非 UML 图的甘特图、架构图等。例如下面的用例图：

## 插入 PlantUML 图形卡片

1. 点击工具栏插入图标 或者 空行行首+号按钮 选择文本绘图，或 输入“/文本绘图”或者 “/wbht ”快捷键方式插入，支持中文、拼音；

2. 在文本绘图卡片右上角，选择「PlantUML」；

3. 你可在卡片左侧使用PlantUML语法编辑，右侧选择模板可实时预览图形。

<img src="https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/AmPdnpgVpyrblw98/img/983f9f40-3ca1-463c-879e-9662147c0d2a.png" referrerPolicy="no-referrer" alt="image.png" />

## 更多支持

详情见 [http://plantuml.com](http://plantuml.com/)

更多真实的 PlantUML 例子可以前往 [https://real-world-plantuml.com](https://real-world-plantuml.com/) 搜索

***

## Mermaid

Mermaid 是一种基于 Javascript 的绘图工具，使用类似于 Markdown 的语法，使用户可以方便快捷地通过代码创建图表。

## 语法

Flowcharts: [https://mermaid.js.org/syntax/flowchart.html](https://mermaid.js.org/syntax/flowchart.html)

Sequence diagrams: [https://mermaid.js.org/syntax/sequenceDiagram.html](https://mermaid.js.org/syntax/sequenceDiagram.html)

Gant diagrams: [https://mermaid.js.org/syntax/gantt.html](https://mermaid.js.org/syntax/gantt.html)

Pie Charts: [https://mermaid.js.org/syntax/pie.html](https://mermaid.js.org/syntax/pie.html)

## 插入 Mermaid 图形卡片

1. 点击工具栏插入图标 或者 空行行首+号按钮 选择文本绘图，或 输入 /文本绘图 或者 /wbht  快捷键方式插入，支持中文，拼音；

2. 在文本绘图卡片右上角，选择「Mermaid」；

3. 可在卡片左侧使用Mermaid语法编辑，右侧选择模板可实时预览图形。

<img src="https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/AmPdnpgVpyrblw98/img/f875d0f1-2188-4f13-a5bf-d5a678cdeade.png" referrerPolicy="no-referrer" alt="image.png" />

## 示例

### 流程图<img src="https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/AmPdnpgVpyrblw98/img/862060c3-e132-4b5f-8e5e-ed1f432b3c4f.png" referrerPolicy="no-referrer" alt="image.png" />

### 时序图

<img src="https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/AmPdnpgVpyrblw98/img/9aec9081-83b1-4494-99ad-1999d16625d0.png" referrerPolicy="no-referrer" alt="image.png" />

### 类图

<img src="https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/AmPdnpgVpyrblw98/img/50e55d85-ab76-4195-91fe-74fb9318ee4a.png" referrerPolicy="no-referrer" alt="image.png" />

### 状态图

<img src="https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/AmPdnpgVpyrblw98/img/666b276b-aa6b-40cc-9691-f3639424f6d3.png" referrerPolicy="no-referrer" alt="image.png" />

### ER图

<img src="https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/AmPdnpgVpyrblw98/img/97f1ddef-8bc6-48f3-9e49-8abc3c8c61cb.png" referrerPolicy="no-referrer" alt="image.png" />

### 甘特图

<img src="https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/AmPdnpgVpyrblw98/img/14153b22-e6e3-4a1f-8f27-42bf91c168f7.png" referrerPolicy="no-referrer" alt="image.png" />

### 饼图

<img src="https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/AmPdnpgVpyrblw98/img/ba8fa620-e812-4528-9663-045eb02c2287.png" referrerPolicy="no-referrer" alt="image.png" />

### 需求图

<img src="https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/AmPdnpgVpyrblw98/img/34fdc73d-a631-4e4a-916e-46ef9066d793.png" referrerPolicy="no-referrer" alt="image.png" />

### Gitgraph图

<img src="https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/AmPdnpgVpyrblw98/img/59eb0ad2-1c09-41da-8f46-34293d4b3176.png" referrerPolicy="no-referrer" alt="image.png" />
