Search code examples
gitlabmarkdown

gitlab markdown numbered & lettered lists


The gitlab markdown doc on lists shows a numbered list with lettered sub-lists. Here's a screenshot (look at number 3 in the formatted list: the sub-bullets have letters, not numbers):

screenshot of gitlab docs

It says that this is possible with:

1. Actual numbers don't matter, just that it's a number
   1. Ordered sub-list
   1. Next ordered sub-list item

But actually using that just produces numbered sub-lists (here and in gitlab).

  1. Actual numbers don't matter, just that it's a number
    1. Ordered sub-list
    2. Next ordered sub-list item

Is it possible to get a list like:

  1. Parent
    a. sub-list item 1
    b. sub-list item 2

Solution

  • Looks like the GitLab documentation is wrong.

    In their Handbook Markdown Guide there's another example that works like your code:

    1. Item one
       1. Sub item one
       1. Sub item two
    1. Item two
    1. Item three
    

    Output

    1. Item one
       1. Sub item one
       2. Sub item two
    2. Item two
    3. Item three
    

    I think I've found an open issue (Docs feedback: misleading GLFM lists syntax) and it looks that the latest code in master branch has been fixed