[GH-ISSUE #234] MD0032: List items without hanging indents should be a violation of this rule #199

New issue

Closed

opened 2026-03-03 01:24:37 +03:00 by kerem · 2 comments

kerem commented

2026-03-03 01:24:37 +03:00

Owner

Originally created by @davrodpin on GitHub (Nov 5, 2019).
Original GitHub issue: https://github.com/DavidAnson/markdownlint/issues/234

I've been using this plugin on my vscode and mdl as part of my continuous integration checks and I noticed the implementation of MD0032 differs a bit:

List items without hanging indents are a violation of this rule; list items with hanging indents are okay:

* This is
not okay

* This is
  okay

Source: https://github.com/markdownlint/markdownlint/blob/master/docs/RULES.md#md032---lists-should-be-surrounded-by-blank-lines

Originally created by @davrodpin on GitHub (Nov 5, 2019). Original GitHub issue: https://github.com/DavidAnson/markdownlint/issues/234 I've been using this plugin on my vscode and [mdl](https://github.com/markdownlint/markdownlint/) as part of my continuous integration checks and I noticed the implementation of MD0032 differs a bit: List items without hanging indents are a violation of this rule; list items with hanging indents are okay: ``` * This is not okay * This is okay ``` Source: https://github.com/markdownlint/markdownlint/blob/master/docs/RULES.md#md032---lists-should-be-surrounded-by-blank-lines

kerem

2026-03-03 01:24:37 +03:00

closed this issue
added the
question
label

kerem commented

2026-03-03 01:24:38 +03:00

Author

Owner

@DavidAnson commented on GitHub (Nov 5, 2019):

Someone pointed out a while ago with that hanging indents are a different category than whether or not a list is surrounded by blanks. Therefore, the documentation for the Node.JS implementation of the library does not include the snippet you cite above: https://github.com/DavidAnson/markdownlint/blob/master/doc/Rules.md#md032---lists-should-be-surrounded-by-blank-lines

The pattern above is known as “lazy continuation lines“ and explicitly allowed by the CommonMark specification: https://spec.commonmark.org/0.29/#lazy-continuation-line

This is therefore a deliberate behavioral change in the Node.JS library. If you’d like, it might be interesting to have this discussion in the issue tracker of the MDL tool as maybe they will agree with my logic. Alternatively, for the best consistency between the command-line and VS Code extension, you might consider switching to the Node.JS CLI: https://github.com/igorshubovych/markdownlint-cli

@DavidAnson commented on GitHub (Nov 5, 2019): Someone pointed out a while ago with that hanging indents are a different category than whether or not a list is surrounded by blanks. Therefore, the documentation for the Node.JS implementation of the library does not include the snippet you cite above: https://github.com/DavidAnson/markdownlint/blob/master/doc/Rules.md#md032---lists-should-be-surrounded-by-blank-lines The pattern above is known as “lazy continuation lines“ and explicitly allowed by the CommonMark specification: https://spec.commonmark.org/0.29/#lazy-continuation-line This is therefore a deliberate behavioral change in the Node.JS library. If you’d like, it might be interesting to have this discussion in the issue tracker of the MDL tool as maybe they will agree with my logic. Alternatively, for the best consistency between the command-line and VS Code extension, you might consider switching to the Node.JS CLI: https://github.com/igorshubovych/markdownlint-cli

kerem commented

2026-03-03 01:24:39 +03:00

Author

Owner

@davrodpin commented on GitHub (Nov 5, 2019):

I will follow your suggestion and try the markdownlint-cli since the rules implementation is the same and that is exactly what I am looking for.

Thank you very much.

@davrodpin commented on GitHub (Nov 5, 2019): I will follow your suggestion and try the `markdownlint-cli` since the rules implementation is the same and that is exactly what I am looking for. Thank you very much.

kerem referenced this issue

2026-03-07 20:03:44 +03:00

[GH-ISSUE #199] MD025/single-title/single-h1 #2019