git.iko.soy/typeable/pandoc
on master help sign in
Documented the "blank line before header and block quote" discrepancy
cf53a18fiddlosopher
@@ -484,6 +484,19 @@ standard markdown (email-style) boxquotes:
484 | They look like this.
484 | They look like this.
485 `----
485 `----
486
486
487+Blank lines before headers and blockquotes
488+------------------------------------------
489+
490+Standard markdown syntax does not require a blank line before a header
491+or blockquote. Pandoc does require this (except, of course, at the
492+beginning of the document). The reason for the requirement is that
493+it is all too easy for a `>` or `#` to end up at the beginning of a
494+line by accident (perhaps through line wrapping). Consider, for
495+example:
496+
497+ I like several of their flavors of ice cream: #22, for example, and
498+ #5.
499+
487Inline LaTeX
500Inline LaTeX
488------------
501------------
489
502