Definition Lists and number of spaces
Nobody has claimed this yet.
- Dominant language
- C#
- Stars
- 5.3k
- Forks
- 510
- Avg merge
- 8d 5h
- Merged PRs (30d)
- 5
Description
I haven't looked at this in a long while but I notice that definition lists require multiple spaces (3) after the colon to work.
In the following markdown the first block works, the second block does not:
First Term
: This is the definition of the first term.
Second Term
: This is one definition of the second term.
: Continues previous term
---
First Term
: This is the definition of the first term.
: This is the definition of the first term.
Second Term
: This is one definition of the second term.
: This is another definition of the second term.

Babelmark seems inconclusive on this with a whole bunch of parsers (including Markdig in that test) failing to render either block:
and quite a few - including PanDoc parsing both blocks.
All parsers seem to recognize the Definition List though because all parsers are generating the headers properly - it's the sub items that are falling through.
Is there a reason that Markdig requires the extra spaces? The parsers that do render the list properly don't require the extra spaces.
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start by reproducing the two definition-list examples from the issue with Markdig and compare their rendered output with the referenced Babelmark results. Determine the intended spacing behavior, then add regression coverage for the agreed syntax and confirm that the affected definitions render correctly.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- csharp, markdown
- Domain
- tooling
- Issue type
- Bug
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 35/100