Markdown 速查表
Markdown 是一种简单的文本排版方式,在任何设备上都能呈现出色的效果。它不做任何花哨的事情,比如改变字号、颜色或字体 – 只保留最核心的部分,使用你早已熟悉的键盘符号。这是一份完整的参考手册:每一条规则都与其渲染结果并排展示。
标题
在文本前使用 # 符号 – 一个 # 表示最大的标题,最多六个表示最小的标题。前两级还有一种“下划线”写法。
| Markdown | 结果 |
|---|---|
# 一级标题 | 一级标题 |
## 二级标题 | 二级标题 |
### 三级标题 | 三级标题 |
#### 四级标题 | 四级标题 |
##### 五级标题 | 五级标题 |
###### 六级标题 | 六级标题 |
强调
用符号把文本包裹起来,即可让它变粗体、斜体或带删除线。星号和下划线的作用完全相同。
| Markdown | 结果 |
|---|---|
*斜体*
_斜体_ | 斜体 |
**粗体**
__粗体__ | 粗体 |
***粗体 & 斜体*** | 粗体 & 斜体 |
~~删除线~~ |
引用
用 > 开头的一行来引用文本。再加一个 > 可以嵌套引用,用空的 > 行来分隔段落。
| Markdown | 结果 |
|---|---|
> 这是一段引用。 | 这是一段引用。 |
> 第一段。
>
> 第二段。 |
|
> 第一层
>> 第二层 | 第一层第二层 |
列表
无序列表以 -、* 或 + 开头。有序列表使用 1.、2.、3. 缩进两个空格即可嵌套子列表。
| Markdown | 结果 |
|---|---|
- 第一项
- 第二项
- 第三项 |
|
1. 第一项
2. 第二项
3. 第三项 |
|
1. 第一项
- 子项
- 子项
2. 第二项 |
|
任务列表
在项目符号后紧接着加上 [ ] 表示未勾选的复选框,或 [x] 表示已勾选的复选框。非常适合在 GitHub 上做待办清单。
| Markdown | 结果 |
|---|---|
- [x] 学习 Markdown
- [ ] 精通 Markdown
- [ ] 教朋友学会 |
|
链接
把可见文本放进 [ ],把地址放进 ( )。引用式链接把地址放在文末,而裸露的 URL 会自动变成链接。
| Markdown | 结果 |
|---|---|
[Markdown69](https://markdown69.com) | Markdown69 |
[悬停看看](https://markdown69.com "最佳速查表") | 悬停看看 |
[引用式链接][site] | 引用式链接 |
<https://markdown69.com> | https://markdown69.com |
[跳到顶部](#top) | 跳到顶部 |
图片
与链接相同,只是前面加一个 !。[ ] 中的文本会成为图片无法加载时显示的替代文本。
| Markdown | 结果 |
|---|---|
 | |
 | |
[](https://markdown69.com) |
代码
行内代码用单个反引号包裹。整段代码则使用三个反引号(可选地注明语言),或将每一行缩进四个空格。
| Markdown | 结果 |
|---|---|
使用 `print()` 函数。 | 使用 print() 函数。 |
```
纯代码块
``` | |
```python
def hello():
print("Hi!")
``` | |
表格
用竖线 | 分隔各列,用短横线 - 把表头与表体分开。在分隔行里加入冒号 : 可让某一列左对齐、居中或右对齐。
| Markdown | 结果 | ||||||
|---|---|---|---|---|---|---|---|
| 语法 | 说明 |
| ------ | ----------- |
| 表头 | 标题 |
| 单元格 | 文本 | |
| ||||||
| 左 | 居中 | 右 |
| :--- | :----: | ----: |
| a | b | c | |
|
分隔线
在单独一行上写三个或更多的短横线、星号或下划线,即可画出一条分隔线。
| Markdown | 结果 |
|---|---|
---
***
___ |
换行
在一行末尾加两个空格,即可换行而不另起一个新段落。空行则总是开始一个新段落。
| Markdown | 结果 |
|---|---|
第一行··
第二行 | 第一行 |
新段落 | 新段落 在空行之后 |
转义字符
在符号前加一个反斜杠 \,即可原样显示该符号,而不对文本进行格式化。
| Markdown | 结果 |
|---|---|
\*非斜体\* | *非斜体* |
1\. 不是列表 | 1. 不是列表 |
脚注
用 [^1] 标记一个位置,并在任意处单独一行写下注释。读者点击即可在两者之间跳转。
| Markdown | 结果 |
|---|---|
这里有一条注释。[^1] | 这里有一条注释。1
|
表情符号
许多编辑器(GitHub、Slack、Discord)会把 :shortcodes: 转换成表情符号。你也可以直接粘贴表情符号字符。
| Markdown | 结果 |
|---|---|
:tada: 发布啦! :rocket: | 🎉 发布啦! 🚀 |
看起来不错 :+1: | 看起来不错 👍 |
内联 HTML
当 Markdown 不够用时,可以直接插入原生 HTML,它会照原样渲染。
| Markdown | 结果 |
|---|---|
带有 <sub>下标</sub> 和 <sup>上标</sup> 的文本。 | 带有 下标 和 上标 的文本。 |
<kbd>Ctrl</kbd> + <kbd>C</kbd> | Ctrl + C |
嵌入视频
Markdown 无法嵌入视频播放器,但你可以把一张缩略图链接到视频。点击图片即可打开视频。
| Markdown | 结果 |
|---|---|
[](https://youtu.be/VIDEO_ID) |