在 Markdown 语法中,有两种方式构建标题,一种是使用 #
,另一种是使用 =/-
。建议使用 #
的方式。
使用 #
的语法如下:
# + 空格 + 标题内容
规则如下:
#
必须位于行首,即#
的前面不能有别的字符。#
的数量决定了标题的层级,1 个#
表示一级标题,2 个#
表示二级标题,以此类推。最多支持六级标题。#
和标题内容之间需要加空格,一般建议加1个空格就可以。- 出于文档易读性的考虑,一般建议最多用四级标题。
示例:
# 这是一级标题
## 这是二级标题
### 这是三级标题
#### 这是四级标题
##### 这是五级标题
###### 这是六级标题
渲染效果如下:
这是一级标题
这是二级标题
这是三级标题
这是四级标题
这是五级标题
这是六级标题
使用 =/-
的语法如下:
一级标题内容
=========
二级标题内容
---------
使用规则如下:
- 这种方式最多只能支持到二级标题。
=
用于一级标题。-
用于二级标题。- 使用
=
或者-
时,数量至少是2个,即标题内容下面跟着至少两个=
或者-
。
示例:
这是一级标题
==
这是二级标题
--
渲染效果如下:
这是一级标题
这是二级标题
标题的使用建议:
-
使用
#
,不要使用=/-
。 -
标题的前后都要空一行(位于文档开头的标题除外)
正确格式:
# 第一章 ## 第1节 第1节正文。 ## 第2节 第2节正文。
错误格式:
# 第一章 ## 第1节 第1节正文。 ## 第2节 第2节正文。
-
在标题的开头和结尾不要加空格。
-
标题的末尾不要加标点符号。
正确格式:
# 第一章 母猪养殖 ## 第1节 母猪产后护理的5个注意事项 第1节正文。
错误格式:
# 第一章 母猪养殖。 ## 第1节 母猪产后护理的5个注意事项: 第1节正文。
-
标题尽量简短。