[GH-ISSUE #146] MD023 in quoted sections that are part of a list unlike Ruby markdownlint #1974

New issue

Closed

opened 2026-03-07 20:03:17 +03:00 by kerem · 0 comments

kerem commented

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

Owner

Originally created by @jpluimers on GitHub (Sep 15, 2018).
Original GitHub issue: https://github.com/DavidAnson/markdownlint/issues/146

MD023 (documentation/source) gets generated within quotes; sort of comparable to https://github.com/DavidAnson/markdownlint/issues/145 as that also blocks Example 3.

This passes in the Ruby version of markdownlint. Their implementation is here.

Example 1: cannot have a quoted heading at level 2 with ## inside a list item

# Heading 1

## Heading 2

- List item

  Continuation of list item
  Continuation of list item
  Continuation of list item
  Continuation of list item

  > ## Quoted heading 2

Example 2: cannot have a quoted heading at level 3 with ### inside a list item

# Heading 1

## Heading 2

- List item

  Continuation of list item
  Continuation of list item
  Continuation of list item
  Continuation of list item

  > ### Quoted heading 3

Example 3: cannot have a quoted heading at level 1 with # inside a list item

# Heading 1

## Heading 2

- List item

  Continuation of list item
  Continuation of list item
  Continuation of list item
  Continuation of list item

  > # Quoted heading 1

Originally created by @jpluimers on GitHub (Sep 15, 2018). Original GitHub issue: https://github.com/DavidAnson/markdownlint/issues/146 MD023 ([documentation](https://github.com/DavidAnson/markdownlint/blob/master/doc/Rules.md#md023---headings-must-start-at-the-beginning-of-the-line)/[source](https://github.com/DavidAnson/markdownlint/blob/master/lib/md023.js)) gets generated within quotes; sort of comparable to https://github.com/DavidAnson/markdownlint/issues/145 as that also blocks Example 3. This [passes in the Ruby version of markdownlint](https://github.com/markdownlint/markdownlint/issues/236#issuecomment-421562805). Their implementation is [here](https://github.com/markdownlint/markdownlint/blob/master/lib/mdl/rules.rb#L299). Example 1: cannot have a quoted heading at level 2 with `##` inside a list item ![screenshot 2018-09-06 13 49 31](https://user-images.githubusercontent.com/2033367/45155564-b9535300-b1db-11e8-99d6-4706f4da058e.png) ``` markdown # Heading 1 ## Heading 2 - List item Continuation of list item Continuation of list item Continuation of list item Continuation of list item > ## Quoted heading 2 ``` Example 2: cannot have a quoted heading at level 3 with `###` inside a list item ![screenshot 2018-09-06 13 53 30](https://user-images.githubusercontent.com/2033367/45155781-6332df80-b1dc-11e8-91a3-ab6a64f0eff8.png) ``` markdown # Heading 1 ## Heading 2 - List item Continuation of list item Continuation of list item Continuation of list item Continuation of list item > ### Quoted heading 3 ``` Example 3: cannot have a quoted heading at level 1 with `#` inside a list item ![screenshot 2018-09-06 14 19 01](https://user-images.githubusercontent.com/2033367/45156927-d2f69980-b1df-11e8-9325-920a2d97f3dc.png) ``` markdown # Heading 1 ## Heading 2 - List item Continuation of list item Continuation of list item Continuation of list item Continuation of list item > # Quoted heading 1 ```