[GH-ISSUE #258] MD036 gets confused by parenthesis #221

New issue

Closed

opened 2026-03-03 01:24:50 +03:00 by kerem · 1 comment

kerem commented

2026-03-03 01:24:50 +03:00

Owner

Originally created by @Arcitec on GitHub (Feb 18, 2020).
Original GitHub issue: https://github.com/DavidAnson/markdownlint/issues/258

Try this document:

# Example

## Example 1

Paragraph 1.

Paragraph 2.

Paragraph 3.

_(Note: Here is a side note which will get flagged by rule MD036.)_

## Example 2

Nothing...

I decided to avoid using parenthesis, since that fixes the linting problem. But it's still weird that it gives such an incorrect linting result in the parenthesis case. :-)

Originally created by @Arcitec on GitHub (Feb 18, 2020). Original GitHub issue: https://github.com/DavidAnson/markdownlint/issues/258 Try this document: ```markdown # Example ## Example 1 Paragraph 1. Paragraph 2. Paragraph 3. _(Note: Here is a side note which will get flagged by rule MD036.)_ ## Example 2 Nothing... ``` I decided to avoid using parenthesis, since that fixes the linting problem. But it's still weird that it gives such an incorrect linting result in the parenthesis case. :-)

kerem

2026-03-03 01:24:50 +03:00

closed this issue
added the
question
label

kerem commented

2026-03-03 01:24:51 +03:00

Author

Owner

@DavidAnson commented on GitHub (Feb 19, 2020):

I don’t think there is an issue here. The relevant part of the rule description:

Note: This rule looks for single line paragraphs that consist entirely of emphasized text. It won't fire on emphasis used within regular text, multi-line emphasized paragraphs, or paragraphs ending in punctuation (normal or full-width).

MD036 fires in your example above because the conditions above are met. MD036 does not fire when the parenthesis are removed because then the paragraph ends in a punctuation character (‘.’).

More: https://github.com/DavidAnson/markdownlint/blob/master/doc/Rules.md#md036---emphasis-used-instead-of-a-heading

@DavidAnson commented on GitHub (Feb 19, 2020): I don’t think there is an issue here. The relevant part of the rule description: > Note: This rule looks for single line paragraphs that consist entirely of emphasized text. It won't fire on emphasis used within regular text, multi-line emphasized paragraphs, or paragraphs ending in punctuation (normal or full-width). MD036 fires in your example above because the conditions above are met. MD036 does not fire when the parenthesis are removed because then the paragraph ends in a punctuation character (‘.’). More: https://github.com/DavidAnson/markdownlint/blob/master/doc/Rules.md#md036---emphasis-used-instead-of-a-heading

kerem referenced this issue

2026-03-07 20:03:57 +03:00

[GH-ISSUE #221] Use a markdown interpreter that doesn't rely on CommonMark #2040