Clarification around list items

[eanyanwu]

First off, I'd like to appreciate the effort and patience you've put into both common mark and djot 🙏🏽 🙏🏽

In trying to understand the syntax better, I ran across what appears to be an inconsistency in nesting block elements inside list items.

playground link

• A bracket (i.e. <) inside a list item gets rendered literally in html (instead of rendering it as a block quote) 👍🏽
• Three colons (i.e. :::) inside a list item gets rendered literally in html (instead of rending it as a <div>) 👍🏽
• But three backticks (i.e. ```) inside a list item gets rendered as a code block 🤔

Is this intentional? If so, can you provide some reasoninng behind it (or a link if this has been brought up before)? I'm just trying to get a feel for the rules

Thanks again!

[matklad]

I think you might have pasted a wrong link :)

[eanyanwu]

woops, fixed 🤦🏽‍♂️

[jgm]

You need a blank line between paragraphs and other block-level elements (block quotes, fenced divs, fenced code).

[jgm]

Sorry, I see now that you are asking why you don't need the blank line before fenced code. Well, you do need it before a fenced code block. What you see in the playground is inline code (which can be between matched pairs of backticks of any length, including 3).

Playground

[eanyanwu]

I see, so the difference is that a code block has both an inline and block "form", but the div and blockquote element do not.

Thanks!

[jgm]

Just a terminological note: "code block" refers to the block element; we don't use that terminology for inline code.