kwin commented on PR #241: URL: https://github.com/apache/maven-doxia/pull/241#issuecomment-2437583393
According to https://spec.commonmark.org/0.31.2/#blank-lines blank lines never have any semantical meaning except within lists. However certain parsers think differently (especially inside block elements in lists, which require a blank line in flexmark with the options we use in Doxia). Compare with https://spec.commonmark.org/0.31.2/#why-is-a-spec-needed-: > Is a blank line needed before a block quote or heading? Most implementations do not require the blank line. However, this can lead to unexpected results in hard-wrapped text, and also to ambiguities in parsing (note that some implementations put the heading inside the blockquote, while others do not). (John Gruber has also spoken [in favor of requiring the blank lines](https://web.archive.org/web/20170611172104/http://article.gmane.org/gmane.text.markdown.general/2146).) > Is a blank line needed before an indented code block? (Markdown.pl requires it, but this is not mentioned in the documentation, and some implementations do not require it.) -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: issues-unsubscr...@maven.apache.org For queries about this service, please contact Infrastructure at: us...@infra.apache.org
