Markdown 撰写文档常见问题 有序列表的缩进

Markdown 可以通过缩进,让列表也进行缩进。但是如果涉及复杂的缩进,比如我曾经使用 Markdown 编写了一个超过 100 编号的有序序列,并且序列里还有多行内容,比如内部再增加一个无序序列以及代码块,这就需要严格遵守 Markdown 的语法了。

严格来说,缩进都应该使用四个空格或是一个制表符,两个空格可能在有限的情况下能够正常使用,但一旦缩进变得复杂了,就容易出错。[图1]是我编写的超过 100 编号的有序序列的一部分,如何在有序序列放置各种信息,可以查看 亚伦斯·沃茨 参与编写的 Markdown 语法 网页。

不过当有序序列的编号超过 100 时,情况又发生了变化,至少在基于 Javascript 的 Marked 与基于 Ruby 的 kramdown 上,都需要增加空格,如[图2][图3]所示,只有四个空格时会出现错误,这时「对齐」,也许是三位数的序号加上「点」与一个空格,已经是五个字符的宽度了,所以需要五个空格。(五到八个空格应该都能正常运行)

#原理 #工具 #指南 #Markdown
 
 
Back to Top