Definition list rendering inconsistent when nested inside bullet lists
0 reputation · 23 Nov 2023, 13:49 UTC
When a definition list appears inside a bullet list, the rendering varies across Markdown engines. The goal is to determine how CommonMark‑supported processors treat such nesting.
The CommonMark spec defines a definition list as a term followed by a colon and indented definitions, but it does not specify whether a definition list can be nested within another definition list or inside a list item. Some processors (e.g., Pandoc with the deflist extension) parse nested lists recursively, while others emit them as plain text.
This ambiguity leads to inconsistent output and potential loss of formatting. The current spec only provides examples, not normative rules, leaving the behavior open to interpretation.
What are the normative rules, if any, for nesting definition lists inside other lists in CommonMark? How should a processor signal that it supports or rejects nested definition lists? What is the recommended approach for authors who need stable rendering across engines?