[GH-ISSUE #52] Erroneous MD003 warning #43

New issue

Closed

opened 2026-03-03 01:23:16 +03:00 by kerem · 3 comments

kerem commented

2026-03-03 01:23:16 +03:00

Owner

Originally created by @zafields on GitHub (Mar 22, 2017).
Original GitHub issue: https://github.com/DavidAnson/markdownlint/issues/52

MD003/header-style: Header style [Expected: setext; Actual: atx]

I get this warning for ### Header Level 3, even though your documentation says it is valid...

The setext_with_atx and settext_with_atx_closed doc styles allow atx-style headers of level 3 or more in documents with setext style headers:

Originally created by @zafields on GitHub (Mar 22, 2017). Original GitHub issue: https://github.com/DavidAnson/markdownlint/issues/52 `MD003/header-style: Header style [Expected: setext; Actual: atx]` I get this warning for `### Header Level 3`, even though your documentation says it is valid... > The setext_with_atx and settext_with_atx_closed doc styles allow atx-style headers of level 3 or more in documents with setext style headers:

kerem

2026-03-03 01:23:16 +03:00

closed this issue
added the
question
label

kerem commented

2026-03-03 01:23:17 +03:00

Author

Owner

@DavidAnson commented on GitHub (Mar 22, 2017):

Can you please provide a small bit of Markdown that demonstrates the problem?

@DavidAnson commented on GitHub (Mar 22, 2017): Can you please provide a small bit of Markdown that demonstrates the problem?

kerem commented

2026-03-03 01:23:17 +03:00

Author

Owner

@DavidAnson commented on GitHub (Mar 23, 2017):

I have an idea for what's going on. By default, the style for MD003 is consistent which means the rule looks at the first header in the file and expects everything else to match that. If you want the settext_with_atx_closed setting to be used, you have to explicitly set it in config.

For example:

{
  "MD003": {
    "style": "setext_with_atx_closed"
  }
}

References:

@DavidAnson commented on GitHub (Mar 23, 2017): I have an idea for what's going on. By default, the `style` for `MD003` is `consistent` which means the rule looks at the first header in the file and expects everything else to match that. If you want the `settext_with_atx_closed` setting to be used, you have to explicitly set it in config. For example: ```json { "MD003": { "style": "setext_with_atx_closed" } } ``` References: - https://github.com/DavidAnson/markdownlint/blob/master/doc/Rules.md#md003---header-style - https://github.com/DavidAnson/markdownlint#configuration

kerem commented

2026-03-03 01:23:17 +03:00

Author

Owner

@DavidAnson commented on GitHub (Mar 28, 2017):

Please let me know if the above does not resolve your issue.

@DavidAnson commented on GitHub (Mar 28, 2017): Please let me know if the above does not resolve your issue.

kerem referenced this issue

2026-03-07 20:02:24 +03:00

[GH-ISSUE #43] Add rule for checking proper formating of fenced code block inside lists #1883