List Items are rendered incorrectly if followed by a table without a blank line in between

[jbridgy]

The Previewer of MM v3.9.12.3 does not render list items correctly if they are followed by a table without a separating blank line.

1. If the item text preceding the table is a single line then MM does not render it at all.
2. If the item spans more than one line then the table is rendered as normal text, not as table.

I think case 1 is a bug because it swallows information and looks fine at first sight.
Case 2 is not nice, but makes sense. It is immediately noticeable that the simplified parser treats the table as normal text.

Interestingly it does not matter whether 'Toggle Soft Returns as Hard Returns' is enabled or not (UseSoftlineBreakAsHardlineBreak in MarkdownMonster.json).

Example as Markdown Text

### Example

#### Standard Item List
* Table 1

    | Header 1       | Header 2       |
    |----------------|----------------|
    | Row 1 Column 1 | Row 1 Column 2 |

* Table 2
    | Header 1       | Header 2       |
    |----------------|----------------|
    | Row 1 Column 1 | Row 1 Column 2 |

* Table 3
  Lorem ipsum ...
  Lorem ipsum ...
    | Header 1       | Header 2       |
    |----------------|----------------|
    | Row 1 Column 1 | Row 1 Column 2 |

#### Numbered Item List
1. Table 1

    | Header 1       | Header 2       |
    |----------------|----------------|
    | Row 1 Column 1 | Row 1 Column 2 |

2. Table 2
    | Header 1       | Header 2       |
    |----------------|----------------|
    | Row 1 Column 1 | Row 1 Column 2 |

3. Table 3
   Lorem ipsum ...
   Lorem ipsum ...
    | Header 1       | Header 2       |
    |----------------|----------------|
    | Row 1 Column 1 | Row 1 Column 2 |

As you can see below, this example is rendered correctly by GitHub, but not by MM.

Example rendered by GitHub

Standard Item List

• Table 1

  Header 1	Header 2
  Row 1 Column 1	Row 1 Column 2

• Table 2

  Header 1	Header 2
  Row 1 Column 1	Row 1 Column 2

• Table 3
  Lorem ipsum ...
  Lorem ipsum ...

  Header 1	Header 2
  Row 1 Column 1	Row 1 Column 2

Numbered Item List

1. Table 1

   Header 1	Header 2
   Row 1 Column 1	Row 1 Column 2

2. Table 2

   Header 1	Header 2
   Row 1 Column 1	Row 1 Column 2

3. Table 3
   Lorem ipsum ...
   Lorem ipsum ...

   Header 1	Header 2
   Row 1 Column 1	Row 1 Column 2

Example rendered by MM Previewer (with 'Soft Returns as Hard Returns' enabled)

[RickStrahl]

This is not specific to list rendering - also happens if you use this text in plain paragraph context:

Lorem ipsum ...
Lorem ipsum ...
| Header 1       | Header 2       |
|----------------|----------------|
| Row 1 Column 1 | Row 1 Column 2 |

Let's see what this renders here on GitHub:

Lorem ipsum ...
Lorem ipsum ...

Header 1	Header 2
Row 1 Column 1	Row 1 Column 2

Works on GitHub.

So the issue here is MarkDig's renderer and likely the the table extension.

This is something that needs to be fixed in MarkDig and should be handled entered as an issue there. I'll take a look and see if can see where this issue comes up in the code of the table extension.

[RickStrahl]

Looks like there's already an issue related to this here:

xoofx/markdig#818

[RickStrahl]

FWIW, it works with a Grid Table:

[RickStrahl]

There's more follow up on this Markdig issue here:

xoofx/markdig#905

Looks like this is a temporary fix that will show up in the next Markdig release. Thanks for @MihaZupan for jumping on this so quickly!

[RickStrahl]

Looks like this is now working @MihaZupan in the latest MarkDig release. 🥳

The fix is available in 4.0.0.2 preview and later.

[RickStrahl]

@jbridgy Also now seems to work with your original scenario of a nested table in a list:

All of the items linked in your original message render now as well.

[jbridgy]

Nice to see that my sample data made it into a Markdig unit test and ultimately helped solve the issue.
Thank you for mentioning xoofx/markdig#818 !

[jbridgy]

Issue resolved in Markdown Monster version 3.10.1 (released on October 30, 2025).