跳转至

基本用法

概述

让我们来看看完成一篇文档所需了解的所有基本功能。

标题

在编写文档时,标题总是必不可少的。

在 Markdown 中,井号(#)帮助我们声明标题。井号越多,标题级别越低。

Markdown 渲染效果
# 一级标题

一级标题

## 二级标题

二级标题

### 三级标题

三级标题

#### 四级标题

四级标题

##### 五级标题
五级标题
###### 六级标题
六级标题
一级和二级标题的另一种写法
Markdown
一级标题
===============

二级标题
---------------

标题下方的等号(=)或短横线(-)数量没有限制。

强调

我们可以通过加粗、斜体和_组合强调_来突出显示文本。

加粗

在文本两侧加上两个星号或下划线即可加粗

Markdown 渲染效果 推荐用法
**加粗** 加粗 ✔
__加粗__ 加粗 ✖

Warning

应避免在行内使用下划线。

fo__o__bar 改为 fo**o**bar。这样 foobar 更易于编辑器和同事理解。

斜体

斜体强调程度不如加粗。只需在文本两侧加一个星号或下划线。

Markdown 渲染效果 推荐用法
*斜体* 斜体 ✖
_斜体_ 斜体 ✔

Warning

如果在行内使用下划线,可能会出现意外情况 😢

This_is_an example. This_is_an example.

This*is*another example. Thisisanother example.

加粗和斜体

比加粗更强烈,需用三个星号或下划线。

Markdown 渲染效果 推荐用法
***重要*** 重要 ✔
___重要___ 重要 ✔
**_重要_** 重要 ✔
__*重要*__ 重要

Warning

如果要在行内使用,建议只用星号。

It's so***important*** It's soimportant

换行与段落

像 HTML 一样,<br> 可以换行。想要新段落?只需中间留一行空行。

Markdown
这是第一行。<br>这是第二行。
这会连接到上一行。

另一段。

这是第一行。
这是第二行。 这会连接到上一行。

另一段。

引用

在行首加大于号(>)即可创建引用。

Markdown
> 这是一段引用。
>
> 我们可以让它成为块引用。
>> 甚至可以嵌套。

这是一段引用。

我们可以让它成为块引用。

甚至可以嵌套。

表格

在 Markdown 中添加表格就像画表格一样。

第二行需加短横线(-),用竖线(|)分隔列。

Markdown
|   | A | B | C |
| - | - | - | - |
| 1 | A1 | B1 | C1 |
| 2 | A2 | B2 | C2 |
| 3 | A3 | B3 | C3 |
A B C
1 A1 B1 C1
2 A2 B2 C2
3 A3 B3 C3

Note

短横线(-)数量可以不同。

Tip

手动创建表格很繁琐,推荐使用在线生成器,如 tablesgenerator.com

对齐方式

冒号(:)可以帮助我们对齐文本。

Markdown
|   | 左对齐 | 居中 | 右对齐 |
| - | :- | :-: | -: |
| 1 | A1 | B1 | C1 |
| 2 | A2 | B2 | C2 |
| 3 | A3 | B3 | C3 |
左对齐 居中 右对齐
1 A1 B1 C1
2 A2 B2 C2
3 A3 B3 C3

Note

默认情况下,表格内容左对齐(如第一列)。

列表

无序列表

要创建无序列表,行首加短横线(-)、星号(*)或加号(+)。

Markdown
- 第一项
- 第二项
- 第三项

* 星号
+ 或加号
  • 第一项
  • 第二项
  • 第三项

  • 星号

  • 或加号

如上所示,如果两个无序列表之间没有空行,它们会被视为一个列表。