Lists¶
Start each item with an asterisk (*) or a dash (-) followed by a space to create a bulleted list:
This is the first item
This is the second item. That goes on for several lines. That goes on for several lines. That goes on for several lines. That goes on for several lines.
And this is the penultimate item
With Sub Items
More than one
And this really is the last item.
Important
A sublist has to be separated by blank lines from the rest of the list, otherwise it is rendered as a definition list. Also, the indentation for the sublist must line up with the first letter of the parent list item.
This is also true for directives inside a list, such as .. seealso::, .. note::, and .. figure::.
Start each item with a number sign and a period (#.) instead of an asterisk or dash to create a numbered list:
This is the first step.
This is the second step.
And so on.
Latest Update |
10/22/2026 |
Clarified how to start bulleted and numbered list items.