基本 Markdown 语法
提示
本页面在本主题下给出了一些常用的基本 Markdown 语法示例,完整的基本 Markdown 语法可以参考 Markdown 基本语法
Markdown 标题
要创建标题,请在单词或短语前面添加井号 (#
) 。#
的数量代表了标题的级别。例如,添加三个 #
表示创建一个三级标题 (<h3>
) (例如:### A subtitle
)。
提示
请注意在 #
和标题之间添加空格,不同markdown处理器对不添加空格的语法有着不同的处理(即未定义行为),可能会产生意想不到的结果。
# 使用这种。
#不要使用这种。
这是一个一级标题
在本百科的页面中,一级标题可以用于标识页面标题,因此不应当在百科中使用一级标题。
二级标题
这是百科内文章的顶级标题,二级标题下会自动添加一根分割线。
三级标题
四级标题
五级标题
六级标题
二、三级标题会被列入页索引中(即“此页内容”),不建议使用五、六级标题,若你的文章确实要用到那么多层标题,请尝试重新为你的文章分类或将其拆分成多个文章。
这是上面文字的源码
# 这是一个一级标题
在本百科的页面中,一级标题可以用于标识页面标题,因此不应当在百科中使用一级标题。
## 二级标题
这是百科内文章的顶级标题,二级标题下会自动添加一根分割线。
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
二、三级标题会被列入页索引中(即“此页内容”),不建议使用五、六级标题,若你的文章确实要用到那么多层标题,请尝试重新为你的文章分类或将其拆分成多个文章。
Markdown 段落
Markdown中用一行空行分段。若您不在两段落间添加空行,这两段会被处理成一段,从排版上看则更加紧凑。
提示
不要用空格(spaces)或制表符( tabs)缩进段落,这可能会产生意想不到的结果
正确的写法。
错误的写法,可能导致排版问题。
这是一段。
因为没有添加空行,这是同一段。
因为添加了空行,这是另一段。
这是上面文字的源码
这是一段。
因为没有添加空行,这是同一段。
因为添加了空行,这是另一段。
Markdown 强调
加粗文本
要加粗文本,请在单词或短语的前后各添加两个星号(**
)。如需加粗一个单词或短语的中间部分用以表示强调的话,请在要加粗部分的两侧各添加两个星号。
倾斜文本
要用斜体显示文本,请在单词或短语前后添加一个星号(*
)。要斜体突出单词的中间部分,请在字母前后各添加一个星号,中间不要带空格。
提示
您可能听说过也可以用下划线(_
)来加粗或倾斜文本,但是下划线的不支持突出单词的中间部分,比如说 abc _def_ ghi
是合法的,会被解释成 “abc def ghi”,而 abc_def_ghi
则不会被解释成斜体,会变成 “abc_def_ghi”,这主要是因为用于表示变量名或其他不能含有空格和连字符的名称的词语经常包含下划线,所以我们不建议您使用下划线。
粗体字
斜体字
这是上面文字的源码
**粗体字**
*斜体字*
Markdown 引用
在段落前加 >
将其标记为引用。添加多个 >
可以嵌套引用。
提示
引用与标题类似,>
与文本之间也需要添加空格。
引用
多级引用
多多级引用
- 在引用内可以自由
使用
其他格式。也可以添加标题
这是上面文字的源码
> 引用
>> 多级引用
>>> 多多级引用
> - 在引用内可以**自***由*`使用`其他格式。
> - ### 也可以添加标题