什么是 Markdown?
Markdown 是由知名独立博主约翰·格鲁伯(John Gruber)发明的轻量级写作语言,通过一些简单的符号语法,就能够在写作的同时完成排版。帮助我们可以专注在文字的内容上,让我们更丝滑地写作,更沉浸式地输出,提升写作的效率。
为什么要使用 Markdown ?
使用 Markdown 写作内容时顺便去输入一些语法符号,让编辑器自动排版,这样的好处在于:当写完这篇文章的同时,也完成了排版,不需要在菜单栏里面去调整字符符号、文字加粗等等,提升写作的效率。- 语法简单:Markdown 的语法是一些简单而且常用的标记符号。即使不是程序员,任何人只要花几分钟就能学会;
- 兼容性强:使用任何编辑器打开,格式都不会乱;
- 专注内容:使用 Markdown 写作再也不用纠结排版,其简洁优雅的格式会让你的双手无需离开键盘,沉浸到写作的乐趣之中。
钉钉文档 Markdown 升级亮点
支持范围
- 完整支持粗体/斜体/删除线/下划线/上下标/高亮文本等多种文本样式
- 新增支持输入 Katex 公式,包括行内样式 、块级样式
- 新增支持高亮块语法
- 新增支持图片、链接语法
- 新增支持 emoji 语法
- 新增支持 ```mermaid + 回车 插入文本绘图
- 新增支持表格语法
-
粘贴转富文本支持 Markdown 内嵌 HTML
细节优化
-
内置多种高亮块颜色,可以通过
::: + <type>快速指定 - 新增辅助输入提示,无需记忆繁多的 代码块语法、高亮块类型、emoji 编码
-
友好的链接 Markdown 输入方式:
- 支持 []() 输入链接占位符并自动 focus 到链接标题输入框
- 支持 [title]() 输入链接,并自动 focus 到链接地址输入框完成输入
- 表格 | | | + 回车 后会插入一个两行两列的表格,并 focus 到首行首列,类似 |x| | + 回车 这样就会 focus 到第二行首列
- 粘贴时会在尽可能需要的时候出现「转为富文本」选项,可以将 Markdown 文本转为钉钉文档支持的格式
Markdown 使用宝典
钉钉文档支持绝大部分 Markdown 语法,你可以在「导入」、「导出」、「粘贴」、「编辑」时使用 Markdown 语法。| 常用 Markdown 语法 | 高阶的 Markdown 语法 |
|---|---|
| * 标题 1-6 * 引用 * 列表:有序列表、无序列表、任务列表等 * 代码块 * 行内代码 * 分割线 * 文本格式:粗体、斜体、下划线、删除线、背景色、上下标等 | * 链接 * 图片 * 公式 * 高亮块 * 表格 * Emoji * 文本绘图 |
导入
在创建文档时,选择「导入为在线文档」- 「本地文档」,选择本地的 .md 文件,即可导入为钉钉文档。
导出
编辑完成后,可以选择下载为 md 文件,完成导出。目前导出时支持的 Markdown 格式:《⏬ 导出为 Markdown 》
粘贴
从纯文本编辑器或 Markdown 编辑器中复制一段 Markdown 文本,然后粘贴到钉钉文档中,在弹出的粘贴选项中点击「转为富文本」,从而转为钉钉文档支持的富文本格式粘贴时支持的 Markdown 格式:《🖨️ 粘贴 Markdown 文本》
编辑
输入特定的 Markdown 格式文本,并输入相应的触发键(空格或回车),将文本转换为对应格式。编辑时支持的 Markdown 格式可查阅:《⌨️ 编辑 Markdown》 请至钉钉文档查看附件《edit markdown.mp4》。Markdown 常用编辑语法大全
| 功能 | Markdown 编辑 | 效果 | |
|---|---|---|---|
| 格式 | 加粗 | **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<br />var a = 1;<br /> | |
| 公式 | 行内公式 | + Space | abc |
| 块级公式 | + Space | abc | |
| 列表 | 有序列表 | 1. + Space a. + Space | 1. 列表 1. 列表 |
| 无序列表 | * + Space - + Space | * 列表 * 列表 | |
| 任务列表 | [] + Space [x] + Space | * [ ] 任务列表 * [x] 任务列表 | |
| 引用 | > + Space | > 引用 | |
| 链接 | []() + Space [abc]() + Space [abc](http://foo) + Space | 添加网页链接 abc abc | |
| 图片 | ![]() + Space  + Space | 请至钉钉文档上传「图片」![]() | |
| 高亮块 | 默认高亮块 | ::: + Enter | ::: 默认效果 ::: |
| 危险高亮块 | :::danger + Enter | ||
| 警示高亮块 | :::warning + Enter | ||
| 信息高亮块 | :::info + Enter | ||
| 成功高亮块 | :::success + Enter | ||
| 提示高亮块 | :::tips + Enter | ||
| Emoji | :smile: + Space | 😄 | |
| 表格 | |a|b| + Enter | ![]() | |
| 分割线 | *** + Enter --- + Enter | --- | |
| 文本绘图 | ```mermaid + Enter | mermaid<br />graph TD<br /> A[Christmas] -->|Get money| B(Go shopping)<br /> B --> C\{Let me think\}<br /> C -->|One| D[Laptop]<br /> C -->|Two| E[iPhone]<br /> C -->|Three| F[fa:fa-car Car]<br /> |
钉钉文档特色 Markdown 用法推荐
快捷输入高亮块
三个冒号(中英文都支持)+ 回车,即可输入高亮块 冒号后带类型,还能快捷设置颜色哦~
辅助输入 emoji、高亮块、代码块
智能的辅助输入,无需记忆繁琐的编码类型,就可以输入:- 支持的 emoji 编码
- 高亮块类型
- 代码块语法
链接的另类输入
支持常见的[title](url) 写法咯
请至钉钉文档查看附件《屏幕录制2022-09-06 下午5.45.34.mov》。

