基本用法
概述
让我们来看看完成一篇文档所需了解的所有基本功能。
标题
在编写文档时,标题总是必不可少的。
在 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 中添加表格就像画表格一样。
第二行需加短横线(-),用竖线(|)分隔列。
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
默认情况下,表格内容左对齐(如第一列)。
列表
无序列表
要创建无序列表,行首加短横线(-)、星号(*)或加号(+)。
- 第一项
- 第二项
-
第三项
-
星号
-
或加号
如上所示,如果两个无序列表之间没有空行,它们会被视为一个列表。