Setext headings in blockquotes #395

New Issue

claunia · 2026-01-29T14:35:43Z

claunia commented

2026-01-29 14:35:43 +00:00

Originally created by @hamvocke on GitHub (Aug 13, 2020).

There seems to be a problem with Setext headings used within blockquotes.

Take this markdown input:

> Hello
> ----
> this is some other text

Running this on babelmark shows that most renderers will generate a blockquote that contains a heading and a paragraph. Markdig, however, creates a blockquote that contains a paragraph, a horizontal rule and another paragraph.

The CommonMark spec is not absolutely explicit about this case but generally states that --- characters should be treated as a Setext heading if they can be interpreted that way.

Is this something that should be fixed in Markdig to be closer to what other Markdown renderers are doing?

Originally created by @hamvocke on GitHub (Aug 13, 2020). There seems to be a problem with [Setext headings](https://spec.commonmark.org/0.29/#setext-heading) used within blockquotes. Take this markdown input: ``` > Hello > ---- > this is some other text ``` Running this on [babelmark](https://babelmark.github.io/?text=%3E+Hello%0A%3E+----%0A%3E+this+is+some+other+text) shows that most renderers will generate a blockquote that contains a heading and a paragraph. Markdig, however, creates a blockquote that contains a paragraph, a horizontal rule and another paragraph. The CommonMark spec is not absolutely explicit about this case but [generally states](https://spec.commonmark.org/0.29/#example-29) that `---` characters should be treated as a Setext heading if they can be interpreted that way. Is this something that should be fixed in Markdig to be closer to what other Markdown renderers are doing?

claunia added the bug PR Welcome! labels 2026-01-29 14:35:43 +00:00

Sign in to join this conversation.

Branches Tags

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: starred/markdig#395