[GH-ISSUE #38] MD029 (ol-prefix) and nested unordered lists in ordered lists #1877

New issue

Closed

opened 2026-03-07 20:02:21 +03:00 by kerem · 2 comments

kerem commented

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

Owner

Originally created by @EvgenyOrekhov on GitHub (Dec 5, 2016).
Original GitHub issue: https://github.com/DavidAnson/markdownlint/issues/38

If I use the following rule:

{
    "ol-prefix": {
        "style": "ordered"
    }
}

then markdownlint says "Ordered list item prefix (Expected: 1; Actual: 2)" to the following code:

1. a
- b
2. c
- d

It looks like markdownlint thinks that 2. c is the beginning of a new list, but it's the second item of the single ordered list.

If I indent the unordered lists, markdownlint says "Consider starting bulleted lists at the beginning of the line".

What is the correct way of using nested unordered lists in ordered lists?

Originally created by @EvgenyOrekhov on GitHub (Dec 5, 2016). Original GitHub issue: https://github.com/DavidAnson/markdownlint/issues/38 If I use the following rule: ```json { "ol-prefix": { "style": "ordered" } } ``` then markdownlint says "Ordered list item prefix (Expected: 1; Actual: 2)" to the following code: ```md 1. a - b 2. c - d ``` It looks like markdownlint thinks that `2. c` is the beginning of a new list, but it's the second item of the single ordered list. If I indent the unordered lists, markdownlint says "Consider starting bulleted lists at the beginning of the line". What is the correct way of using nested unordered lists in ordered lists?

kerem

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

closed this issue
added the
question
label

kerem commented

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

Author

Owner

@DavidAnson commented on GitHub (Dec 5, 2016):

When indenting, did you use three spaces? The following should do what you want:

1. a
   - b
2. c
   - d

Markers for nested lists should begin under the text of the previous item - for numbered lists that's typically 3 vs. 2 spaces.

You can play around interactively here to see that markdown-it doesn't recognize the nested lists with just 2 spaces: https://dlaa.me/markdownlint/

@DavidAnson commented on GitHub (Dec 5, 2016): When indenting, did you use three spaces? The following should do what you want: ``` 1. a - b 2. c - d ``` Markers for nested lists should begin under the text of the previous item - for numbered lists that's typically 3 vs. 2 spaces. You can play around interactively here to see that `markdown-it` doesn't recognize the nested lists with just 2 spaces: https://dlaa.me/markdownlint/

kerem commented

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

Author

Owner

@EvgenyOrekhov commented on GitHub (Dec 6, 2016):

@DavidAnson thanks!

@EvgenyOrekhov commented on GitHub (Dec 6, 2016): @DavidAnson thanks!

kerem referenced this issue

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

[PR #1877] [MERGED] Bump eslint-plugin-jsdoc from 61.4.0 to 61.4.1 #3619