【问题标题】:formatting nested list on github在 github 上格式化嵌套列表
【发布时间】:2018-02-19 10:35:12
【问题描述】:
有没有办法在 github 的嵌套列表中标注段落应该属于哪个级别?
- level 1 para 1
- level 2 para 1 (trailing spaces added)
level 2 para 2
level 1 para 2
我无法让上述内容在 github 上运行,即使它在其他 markdown 渲染器上正确渲染也是如此。任何人都知道这样做的方法还是github错误?
【问题讨论】:
标签:
github
gitlab
markdown
github-flavored-markdown
【解决方案1】:
您需要在段落之间添加空行。
了解在列表中嵌套项目时,在这些项目之间应用相同的语法规则很重要。因此,让我们以“2级”段落为例。如果您要在文档根目录中包含这些段落,则它们需要有一个空行分隔它们。像这样:
level 2 para 1
level 2 para 2
因此,将它们嵌套在列表中时,同样适用。当然,你还需要缩进来表示它们是嵌套的。像这样:
- level 2 para 1
level 2 para 2
现在,如果您要在该列表项之前和之后包含一个段落,那么您应该这样做(再次注意空行):
level 1 para 1
- level 2 para 1
level 2 para 2
level 1 para 2
当然,要将所有内容嵌套在一个列表项中,您需要一些额外的缩进。但是,您不能仅仅因为文本嵌套在列表项中而删除空行。因此,你需要这个:
- level 1 para 1
- level 2 para 1
level 2 para 2
level 1 para 2
最后,关于您尝试插入换行符(尾随空格)的尝试,这将(在某种程度上)在两个段落之间起作用,但当然它永远不会在列表项和段落之间起作用。由于您至少需要级别 1 和级别 2 之间的空白行,因此您也可以在级别 2 中包含空白行。