Bug with Numbered list

Product Support

AI-generated summary

Bug with Numbered List

A bug has been reported where numbered lists reset their numbering when comments or text are inserted between list items. zbor demonstrated the issue and found a workaround by using Preformatted Text tags around the list items.

zbor showed that using backticks (`) before the number and period can maintain the correct numbering. Falco explained that this is a known limitation of markdown and provided examples of how lists can be broken. zbor also discovered that if there is no empty row above the next list item, the list will continue to count correctly.

codinghorror confirmed that this is the way Markdown works.

1

When the list is Numbered it’s fine.

  1. Number one
  2. Number two
  3. Number three

But as soon you have some comments in between list then it resets numbers, no matter what you write.

  1. Number four

Some text here

  1. Number five

Some text here

image.png905×387 20.6 KB

2

There is a workaround to put Preformatted Text tags around:

When the list is Numbered it’s fine.

  1. Number one
  2. Number two
  3. Number three

But as soon you have some comments in between list then it resets numbers, no matter what you write.

4. Number four

Some text here

5. Number five

Some text here

3

Yeah, this is a known limitation of markdown, you can’t break the list:

1. Test

2. Another
Comment

3. Works
<br>
If you never break the block

4. See?

  1. Test

  2. Another
    Comment

  3. Works


    If you never break the block

  4. See?

Markdown-it makes this a little better by allowing lists to start at arbitrary numbers.

4

Ok, thx for the link

Edit:

To make in simple words to someone who could find this usefull
I’ve found that if you don’t have empty row above (write anything) the list will continue to count.

image.png1189×497 116 KB

In the example number 4 has _ above while number 5 has empty row.

5

This is the way Markdown works.