Markdown 语法本身可以支持6级标题,但为了增强文档的易读性,建议最多使用4级标题。
-
一级标题
一级标题一般作为整篇文章的标题。
-
二级标题
二级标题一般作为文章主要部分的大标题。
-
三级标题
三级标题是对二级标题所描述内容的细分。
-
四级标题
四级标题是对三级标题所描述内容的细分。
对于标题的使用,建议遵循如下原则:
- 标题层层递进,不要跨层。举例来说,一级标题下面只能使用二级标题,不要直接出现三级或者四级标题。
- 不要出现同级标题只有一个的情况。例如,如果二级标题下面只有一个三级标题,那就要考虑重新组织文档,从而把三级标题去掉。
- 下级标题不要重复上一级标题的内容。
- 谨慎使用四级标题。在组织文章内容时,尽量避免层级过深,简单的层级关系有助于提高文章的可读性。如果三级标题下面有并列的内容,优先考虑用项目列表的形式实现。
参考链接:阮一峰的Github