跳转到主要内容

什么是 Markdown?

image.png   Markdown 是由知名独立博主约翰·格鲁伯(John Gruber)发明的轻量级写作语言,通过一些简单的符号语法,就能够在写作的同时完成排版。帮助我们可以专注在文字的内容上,让我们更丝滑地写作,更沉浸式地输出,提升写作的效率。

为什么要使用 Markdown ?

使用 Markdown 写作内容时顺便去输入一些语法符号,让编辑器自动排版,这样的好处在于:当写完这篇文章的同时,也完成了排版,不需要在菜单栏里面去调整字符符号、文字加粗等等,提升写作的效率。

Markdown 的优点

语法简单兼容性强专注内容
  • 语法简单:Markdown 的语法是一些简单而且常用的标记符号。即使不是程序员,任何人只要花几分钟就能学会;
  • 兼容性强:使用任何编辑器打开,格式都不会乱;
  • 专注内容:使用 Markdown 写作再也不用纠结排版,其简洁优雅的格式会让你的双手无需离开键盘,沉浸到写作的乐趣之中。

钉钉文档 Markdown 升级亮点

支持范围

  • 完整支持粗体/斜体/删除线/下划线/上下标/高亮文本等多种文本样式
  • 新增支持输入 Katex 公式,包括行内样式 a+ba+b、块级样式 a+ba+b
  • 新增支持高亮块语法
  • 新增支持图片链接语法
  • 新增支持 emoji 语法
  • 新增支持 ```mermaid + 回车 插入文本绘图
  • 新增支持表格语法
  • 粘贴转富文本支持 Markdown 内嵌 HTML

    细节优化

  • 内置多种高亮块颜色,可以通过 ::: + <type> 快速指定
  • 新增辅助输入提示,无需记忆繁多的 代码块语法高亮块类型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<br />var a = 1;<br />
公式行内公式texttext + Spaceabca+ba+b
块级公式texttext + Spaceabc
a+ba+b
列表有序列表1. + Space
a. + Space
1. 列表

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

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

* [x] 任务列表
引用> + Space> 引用
链接[]() + Space
[abc]() + Space
[abc](http://foo) + Space
添加网页链接
abc
abc
图片![]() + Space
![](http://foo/bar) + Space
请至钉钉文档上传「图片」
image
高亮块默认高亮块::: + Enter:::
默认效果
:::
危险高亮块:::danger + Enter
警示高亮块:::warning + Enter
信息高亮块:::info + Enter
成功高亮块:::success + Enter
提示高亮块:::tips + Enter
Emoji:smile: + Space😄
表格|a|b| + Enterimage.png
分割线*** + Enter
--- + Enter
---
文本绘图```mermaid + Entermermaid<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 用法推荐

快捷输入高亮块

三个冒号(中英文都支持)+ 回车,即可输入高亮块 冒号后带类型,还能快捷设置颜色哦~ image.png

辅助输入 emoji、高亮块、代码块

智能的辅助输入,无需记忆繁琐的编码类型,就可以输入:
  • 支持的 emoji 编码
  • 高亮块类型
  • 代码块语法
请至钉钉文档查看附件《辅助输入.mov》。

链接的另类输入

支持常见的 [title](url) 写法咯 请至钉钉文档查看附件《屏幕录制2022-09-06 下午5.45.34.mov》。

快捷输入文本绘图

```mermaid + 回车 像输入代码块一样添加文本绘图~ 请至钉钉文档查看附件《屏幕录制2022-09-28 上午11.35.08.mov》。