Markdown 原子降价警告

Markdown 原子降价警告,markdown,atom-editor,Markdown,Atom Editor,使用Atom 1.17.0 x64,使用 鉴于: # Header - list item # Header 2 - list item 2 Atom“备注lint”给了我相互矛盾的警告 Incorrect list-item indent: add 2 spaces (remark-lint:list-item-indent) Incorrect indentation Before bullet: remove 2 spaces (remark-lint:lint-item-

使用Atom 1.17.0 x64,使用

鉴于:

# Header

- list item

# Header 2

  - list item 2

Atom“备注lint”给了我相互矛盾的警告

Incorrect list-item indent: add 2 spaces (remark-lint:list-item-indent)

Incorrect indentation Before bullet: remove 2 spaces (remark-lint:lint-item-bullet-indent)

我做错了什么?

您正在将列表项缩进两个空格,而不是四或零。虽然大多数降价解析器都会使用嵌套列表中少于四个空格的缩进来完成预期的操作,但它可能会变得模棱两可,尤其是在每个级别的空格数不一致的情况下

您的“列表项2”是否打算成为根级别的列表项?如果是,则不应缩进。或者它是代码块的一部分(可能演示列表项的标记语法)?然后它应该缩进四个空格。你的意图不清楚,所以林特给了你两个错误,并允许你根据你的意图选择要解决的问题

例如,虽然缩进列表项显然没有父列表项(标题不是列表项),但我第一眼就忽略了这一点,并假设它是要嵌套在前一项下的。换句话说,缩进的两个空格引入了歧义

林特鼓励“最佳实践”,而不仅仅是“足够好”。由于规则没有明确规定允许少于四个空格,所以linter严格执行四个空格规则,即使解析器没有这样做。因此,“最佳实践”是只在四个空间增量中使用缩进。这就是林特所期望的

以下是本手册的相关部分,以供参考:

列表项可以由多个段落组成。列表项中的每个后续段落必须缩进4个空格或一个制表符

要将代码块放入列表项中,代码块需要缩进两次-8个空格或两个制表符


用四个空格缩进会给我带来评论:(