在Markdown语法中,标题支持使用两种标记:底线(-/=)和#。
Markdown标题 底线表示
或
语法说明如下。
底线是=表示一级标题。
底线是-表示二级标题。
底线符号的数量至少2个。
这种语法只支持这两级标题。
实例演示如下。
Markdown标题#表示
语法说明如下。
在行首插入#可标记出标题。
#的个数表示了标题的等级。
建议在#后加一个空格。
Markdown中最多只支持前六级标题。实例演示如下。
使用规范
建议使用#标记标题,而不是===或-,因为后者会难以阅读和维护。
推荐:
不推荐:
要保持间距,建议标题的前后都要空1行(除非标题在文档开头);#与标题文本之间也要有1个空格,否则会导致阅读困难。
推荐:
不推荐:
不要有多余的空格。建议标题要写在一行的开头,结尾也不要有空格。
推荐:
不推荐:
建议标题的结尾不要有标点符号,如句号、逗号、冒号、分号等。
推荐:
不推荐:
建议标题要尽量简短,这样方便引用,特别是当生成目录时。如果原拟的标题是一个长句,可以从长句中提取标题,而将长句作为标题下的内容。
推荐:
不推荐:
使用Markdown写文档比较推荐的结构如下。
说明如下。
文档标题:文档的第一个标题应该是一级标题,写在第一行,建议与文件名相同,标题要尽量简短。
作者:可选,用于声明文档的作者,如果是开源项目的文档,建议把作者名写在修订历史中。
摘要:用1~3句话描述文档的核心内容。
目录:用于快速了解文档的结构,便于导航。
正文:正文中的标题从二级目录开始,逐级增加,不可跳级,不可相同。