MD032 - blanks-around-lists

Description

This rule enforces blank lines around lists. It triggers when lists (ordered or unordered) are not preceded or followed by a blank line. The first list in a document does not require a blank line above, and the last list at the end of a document does not require a blank line below.

Rationale

Aside from aesthetic reasons, some Markdown parsers require a blank line before a list when it follows a paragraph, or the list items may be treated as plain text.

Examples

Invalid

Some text here.
* Item 1
* Item 2
* Item 3

1. First
2. Second
3. Third
# More text here.

Valid

Some text here.

* Item 1
* Item 2
* Item 3

More text here.

1. First
2. Second
3. Third

Final text.