> ## 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. # Markdown 使用手册 > 钉钉文档 Markdown 使用手册：介绍什么是 Markdown、其语法优势，以及钉钉文档对粗体、斜体、删除线、代码块等语法的完整支持范围，帮助提升写作与排版效率。 ## 什么是 Markdown？ image.png   Markdown 是由知名独立博主约翰·格鲁伯（John Gruber）发明的轻量级写作语言，通过一些简单的符号语法，就能够在写作的同时完成排版。帮助我们可以专注在文字的内容上，让我们更丝滑地写作，更沉浸式地输出，提升写作的效率。 ## 为什么要使用 Markdown ？ 使用 Markdown 写作内容时顺便去输入一些语法符号，让编辑器自动排版，这样的好处在于：当写完这篇文章的同时，也完成了排版，不需要在菜单栏里面去调整字符符号、文字加粗等等，提升写作的效率。 ## Markdown 的优点 **语法简单** **兼容性强** **专注内容** * 语法简单：Markdown 的语法是一些简单而且常用的标记符号。即使不是程序员，任何人只要花几分钟就能学会； * 兼容性强：使用任何编辑器打开，格式都不会乱； * 专注内容：使用 Markdown 写作再也不用纠结排版，其简洁优雅的格式会让你的双手无需离开键盘，沉浸到写作的乐趣之中。 ## 钉钉文档 Markdown 升级亮点 ### 支持范围 * 完整支持粗体/**斜体**/**删除线**/**下划线**/**上下标**/高亮文本等多种文本样式 * 新增支持输入 Katex **公式**，包括行内样式 **$a+b$**、块级样式 **$a+b$** * 新增支持高亮块语法 * 新增支持图片、链接语法 * 新增支持 **emoji** 语法 * 新增支持 **\`\`\`mermaid** + **回车** 插入文本绘图 * 新增支持表格语法 * 粘贴转富文本支持 Markdown 内嵌 HTML #### 细节优化 * 内置多种高亮块颜色，可以通过 `::: + ` 快速指定 * 新增辅助输入提示，无需记忆繁多的 **代码块语法**、**高亮块类型**、**emoji 编码** * 友好的链接 Markdown 输入方式： * 支持 **\[]\()** 输入链接占位符并自动 focus 到链接标题输入框 * 支持 **\[title]\()** 输入链接，并自动 focus 到链接地址输入框完成输入 * 表格 **| | |** + **回车** 后会插入一个两行两列的表格，并 focus 到首行首列，类似 **|x| |** + **回车** 这样就会 focus 到第二行首列 * 粘贴时会在尽可能需要的时候出现「转为富文本」选项，可以将 Markdown 文本转为钉钉文档支持的格式 ## Markdown 使用宝典 钉钉文档支持绝大部分 Markdown 语法，你可以在「**导入**」、「**导出**」、「**粘贴**」、「**编辑**」时使用 Markdown 语法。 | 常用 Markdown 语法 | 高阶的 Markdown 语法 | | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | \* **标题 1-6**

\* **引用**

\* **列表**：有序列表、无序列表、任务列表等

\* **代码块**

\* **行内代码**

\* **分割线**

\* **文本格式**：粗体、斜体、下划线、删除线、背景色、上下标等 | \* **链接**

\* **图片**

\* **公式**

\* **高亮块**

\* **表格**

\* **Emoji**

\* **文本绘图** | ### 导入 在创建文档时，选择「导入为在线文档」- 「本地文档」，选择本地的 .md 文件，即可导入为钉钉文档。 Kapture 2022-10-31 at 18.53.23.gif ### 导出 编辑完成后，可以选择下载为 md 文件，完成导出。目前导出时支持的 Markdown 格式：《⏬ 导出为 Markdown 》 image.png ### 粘贴 从纯文本编辑器或 Markdown 编辑器中复制一段 Markdown 文本，然后粘贴到钉钉文档中，在弹出的粘贴选项中点击「转为富文本」，从而转为钉钉文档支持的富文本格式粘贴时支持的 Markdown 格式：《 粘贴 Markdown 文本》 Kapture 2022-10-31 at 22.04.05.gif ### 编辑 输入特定的 Markdown 格式文本，并输入相应的触发键（空格或回车），将文本转换为对应格式。编辑时支持的 Markdown 格式可查阅：《⌨️ 编辑 Markdown》 请至钉钉文档查看附件《edit markdown.mp4》。 ## Markdown 常用编辑语法大全 | **功能** | | **Markdown 编辑** | **效果** | | --------- | --------- | ------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **格式** | **加粗** | \*\*text\*\* + Space
\_\_text\_\_ + Space | **粗体** | | | **斜体** | \*text\* + Space
\_text\_ + Space | *斜体* | | | **删除线** | ~~text~~ + Space | ~~删除线~~ | | | **下划线** | text + Space | 下划线 | | | **上标** | ^text^ + Space | ^上标^ | | | **下标** | ~~text~~ + Space | ~~下标~~ | | | **文本高亮** | ==text== + Space | ==文本高亮== | | | **行内代码** | \`text\` + Space | `行内代码` | | **标题** | **标题 1** | # + Space | # 标题1 | | | **标题 2** | ## + Space | ## 标题2 | | | **标题 3** | ### + Space | ### 标题3 | | | **标题 4** | #### + Space | #### 标题4 | | | **标题 5** | ##### + Space | ##### 标题5 | | | **标题 6** | ###### + Space | ###### 标题6 | | **代码块** | | \`\`\` + Enter
\`\`\`js + Enter | `text/x-sh
var a = 1;
` | | **公式** | **行内公式** | $text$ + Space | abc$a+b$ | | | **块级公式** | $text$ + Space | abc
$a+b$ | | **列表** | **有序列表** | 1. + Space
a. + Space | 1. 列表

1. 列表 | | | **无序列表** | \* + Space
- + Space | \* 列表

\* 列表 | | | **任务列表** | \[] + Space
\[x] + Space | \* \[ ] 任务列表

\* \[x] 任务列表 | | **引用** | | > + Space | > 引用 | | **链接** | | \[]\() + Space
\[abc]\() + Space
\[abc]\([http://foo](http://foo)) + Space | 添加网页链接
abc
[abc](https://foo) | | **图片** | | !\[]\() + Space
!\[]\([http://foo/bar](http://foo/bar)) + Space | 请至钉钉文档上传「图片」
image | | **高亮块** | **默认高亮块** | ::: + Enter | :::
默认效果
::: | | | **危险高亮块** | :::danger + Enter | | | | **警示高亮块** | :::warning + Enter | | | | **信息高亮块** | :::info + Enter | | | | **成功高亮块** | :::success + Enter | | | | **提示高亮块** | :::tips + Enter | | | **Emoji** | | :smile: + Space | | | **表格** | | \|a\|b\| + Enter | image.png | | **分割线** | | \*\*\* + Enter
--- + Enter | --- | | **文本绘图** | | \`\`\`mermaid + Enter | `mermaid
graph TD
A[Christmas] -->\|Get money\| B(Go shopping)
B --> C\{Let me think\}
C -->\|One\| D[Laptop]
C -->\|Two\| E[iPhone]
C -->\|Three\| F[fa:fa-car Car]
` | ## 钉钉文档特色 Markdown 用法推荐 ### 快捷输入高亮块 三个冒号（中英文都支持）+ 回车，即可输入高亮块 冒号后带类型，还能快捷设置颜色哦～ image.png ### 辅助输入 emoji、高亮块、代码块 智能的辅助输入，无需记忆繁琐的编码类型，就可以输入： * 支持的 emoji 编码 * 高亮块类型 * 代码块语法 请至钉钉文档查看附件《辅助输入.mov》。 ### 链接的另类输入 支持常见的 `[title](url)` 写法咯 请至钉钉文档查看附件《屏幕录制2022-09-06 下午5.45.34.mov》。 ### 快捷输入文本绘图 \`\`\`mermaid + 回车 像输入代码块一样添加文本绘图～ 请至钉钉文档查看附件《屏幕录制2022-09-28 上午11.35.08.mov》。