starred/markdownlint

Fork 0

mirror of https://github.com/DavidAnson/markdownlint.git synced 2026-04-25 17:26:22 +03:00

[GH-ISSUE #125] "MD029 - Ordered list item prefix" when list includes code blocks in fences #1953

New issue

Closed

opened 2026-03-07 20:03:05 +03:00 by kerem · 6 comments

kerem commented

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

Owner

Originally created by @jpluimers on GitHub (Jun 6, 2018).
Original GitHub issue: https://github.com/DavidAnson/markdownlint/issues/125

The below code throws https://github.com/DavidAnson/markdownlint/blob/v0.10.0/doc/Rules.md#md029 on the last line.

## Test

1. Run this script:

  ``` batch
  cls
  ```

2. Start Task Manager

Markdown rendering works fine though, as the second item is indeed numbered "2":

Test

Run this script:

cls

Start Task Manager

Originally created by @jpluimers on GitHub (Jun 6, 2018). Original GitHub issue: https://github.com/DavidAnson/markdownlint/issues/125 The below code throws https://github.com/DavidAnson/markdownlint/blob/v0.10.0/doc/Rules.md#md029 on the last line. ## Test 1. Run this script: ``` batch cls ``` 2. Start Task Manager Markdown rendering works fine though, as the second item is indeed numbered "2": ## Test 1. Run this script: ``` batch cls ``` 2. Start Task Manager

kerem

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

closed this issue
added the
question
label

kerem commented

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

Author

Owner

@DavidAnson commented on GitHub (Jun 6, 2018):

Your idea to test for same/new list was good, but thwarted by the fact some parsers allow list number continuation. :)

The following tweak to your example demonstrates that your scenario is actually two lists, not one, so the reported violation is correct:

## Test

1. Run this script:

  ``` batch
  cls
  ```

1. Start Task Manager
1. Fin

The fix is to indent the code fence 3 spaces to line up with the start of first column of the list item above which tells the parser it is part of the item (not a separate block):

## Test

1. Run this script:

   ``` batch
   cls
   ```

1. Start Task Manager
1. Fin

@DavidAnson commented on GitHub (Jun 6, 2018): Your idea to test for same/new list was good, but thwarted by the fact some parsers allow list number continuation. :) The following tweak to your example demonstrates that your scenario is actually two lists, not one, so the reported violation is correct: ```` ## Test 1. Run this script: ``` batch cls ``` 1. Start Task Manager 1. Fin ```` The fix is to indent the code fence 3 spaces to line up with the start of first column of the list item above which tells the parser it is part of the item (not a separate block): ```` ## Test 1. Run this script: ``` batch cls ``` 1. Start Task Manager 1. Fin ````

kerem commented

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

Author

Owner

@DavidAnson commented on GitHub (Jun 6, 2018):

Here’s a link to the updated sample in the markdown-it parser: sample

@DavidAnson commented on GitHub (Jun 6, 2018): Here’s a link to the updated sample in the `markdown-it` parser: [sample](https://markdown-it.github.io/#md3=%7B%22source%22%3A%22%23%23%20Test%5Cn%5Cn1.%20Run%20this%20script%3A%5Cn%5Cn%20%20%60%60%60%20batch%5Cn%20%20cls%5Cn%20%20%60%60%60%5Cn%5Cn1.%20Start%20Task%20Manager%5Cn1.%20Fin%22%2C%22defaults%22%3A%7B%22html%22%3Afalse%2C%22xhtmlOut%22%3Afalse%2C%22breaks%22%3Afalse%2C%22langPrefix%22%3A%22language-%22%2C%22linkify%22%3Atrue%2C%22typographer%22%3Atrue%2C%22_highlight%22%3Atrue%2C%22_strict%22%3Afalse%2C%22_view%22%3A%22html%22%7D%7D)

kerem commented

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

Author

Owner

@jpluimers commented on GitHub (Jun 6, 2018):

Thanks for teaching me this. I never noticed that markdown can start lists at non-1.

@jpluimers commented on GitHub (Jun 6, 2018): Thanks for teaching me this. I never noticed that markdown can start lists at non-1.

kerem commented

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

Author

Owner

@ChristianStadelmann commented on GitHub (Jan 19, 2021):

@DavidAnson wrote:

The fix is to indent the code fence 3 spaces to line up with the start of first column of the list item above which tells the parser it is part of the item (not a separate block):
## Test

1. Run this script:

   ``` batch
   cls
Start Task Manager

Fin

Actually, this gives you the MD046 warning. Is this by intention? Is something wrong with this example?

@ChristianStadelmann commented on GitHub (Jan 19, 2021): @DavidAnson wrote: > The fix is to indent the code fence 3 spaces to line up with the start of first column of the list item above which tells the parser it is part of the item (not a separate block): > > ``` > ## Test > > 1. Run this script: > > ``` batch > cls > ``` > > 1. Start Task Manager > 1. Fin > ``` Actually, this gives you the MD046 warning. Is this by intention? Is something wrong with this example?

kerem commented

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

Author

Owner

@DavidAnson commented on GitHub (Jan 19, 2021):

@ChristianStadelmann That example does not produce MD046: https://dlaa.me/markdownlint/#%25m%23%20Test%0A%0A1.%20Run%20this%20script%3A%0A%0A%20%20%20%60%60%60%20batch%0A%20%20%20cls%0A%20%20%20%60%60%60%0A%0A1.%20Start%20Task%20Manager%0A1.%20Fin%0A

You might be seeing it in your document if you are using the default "consistent" style and have an indented code block earlier in the document - that indented code and the example's fenced code would not be consistent.

@DavidAnson commented on GitHub (Jan 19, 2021): @ChristianStadelmann That example does not produce MD046: https://dlaa.me/markdownlint/#%25m%23%20Test%0A%0A1.%20Run%20this%20script%3A%0A%0A%20%20%20%60%60%60%20batch%0A%20%20%20cls%0A%20%20%20%60%60%60%0A%0A1.%20Start%20Task%20Manager%0A1.%20Fin%0A You might be seeing it in your document if you are using the default "consistent" style and have an indented code block earlier in the document - that indented code and the example's fenced code would not be consistent.

kerem commented

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

Author

Owner

@ChristianStadelmann commented on GitHub (Jan 20, 2021):

Ok, thanks for explaining!

@ChristianStadelmann commented on GitHub (Jan 20, 2021): Ok, thanks for explaining!

kerem referenced this issue

2026-03-07 20:09:34 +03:00

[GH-ISSUE #1953] MD056 incorrectly handles the escaped | char #2636