Bullet lists / unordered lists¶
This section contains information on bullet lists and numbered lists. A text block which begins with a "*", "+", "-", "•", "‣", or "⁃", followed by whitespace, is a bullet list item.
Each item of a list should start with a
*
or-
and 3 spaces after itLists should have an empty line before and after
Sublists should also have an empty line before and after
Indent sublists with 4 spaces
Bullet lists:
Each item of a list should start with a
*
or-
and 3 spaces after it
Numbered lists:
Start each item with a
#.
and 1 space after it for automatic numbering
See also:
Example 1: List with sublist items¶
* item 1
* item 2 is a longer text with line breaks. We can format and
indent like this
* item 3
* subitem 3.1
* subitem 3.2
* item 4
How it looks:
item 1
item 2 is a longer text with line breaks. We can format and indent like this
item 3
subitem 3.1
subitem 3.2
item 4
Example 2: List with sublist and error¶
Important
This example will not work as expected, because the extra lines for the sublist are missing.
* item 1
* item 2
* item 3
* subitem 3.1
* subitem 3.2
* item 4
How it looks:
item 1
item 2
item 3 * subitem 3.1 * subitem 3.2
item 4
Example 3: List with sublist and whitespace error¶
Important
Each asterix *
has to be followed by three spaces.
If you only use one the sublist is interpreted like
a citation.
* item 1
* item 2
* item 3
* subitem 3.1
* subitem 3.2
* item 4
How it looks:
item 1
item 2
item 3
subitem 3.1
subitem 3.2
item 4
For more information on common errors, see Common pitfalls.