Join 34,000+ subscribers and receive articles from our blog about software quality, testing, QA and security.

Some extra dots cause issues with numerated lists in test cases description


The issue with numerated lists has been occurred. In the test step description several dots were used. Also, there was a numerated list in one test step e.g.

  1. Some description … .
  2. Another one … .

Although, after saving, the numerated list has only 1 as a number for all steps e.g.

  1. Some description … .
  2. Another one … .

Screenshot taken from Edit and View mode:


Hi Artem,

Thanks for your post! TestRail uses the popular Markdown formatting syntax for text fields, and this is the expected functionality as Markdown would automatically number the list for you when using a dot directly after a number at the start of a line (e.g. when using “1.” and “2.”). As there is a line break between the first number and the second number, the list starts back over at 1 on the second number as Markdown is detecting a new and separate list. You can see how this works on our website here:

You can avoid having the numbers automatically listed by indenting the line with 4 spaces as this would assume a code block and display the text as-is. If you eliminate the line break then this would also just increment the numbered list for you automatically. You can also alternatively use a separate symbol for the manual number list, e.g. such as “1)”, “1 -”, or similar.

Hope this helps!