MD028 - no-blanks-blockquote¶
Description¶
This rule detects when two blockquote sections are separated only by blank lines, without any intervening text. This creates ambiguous Markdown that may be parsed differently by different implementations.
Rationale¶
Some Markdown parsers will treat two blockquotes separated by one or more blank lines as the same blockquote, while others will treat them as separate blockquotes. To avoid ambiguity, either add text between blockquotes to clearly separate them, or use the blockquote marker (>) on blank lines to explicitly continue the same blockquote.
Examples¶
Invalid¶
> This is a blockquote
> which is immediately followed by
> this blockquote. Unfortunately
> in some parsers, these are treated as the same blockquote.
Valid¶
> This is a blockquote.
And Jimmy also said:
> This too is a blockquote.