Bullet 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 2 spaces after it
Lists should have an empty line before and after
Sublists should also have an empty line before and after
Indent sublists with 3 spaces

Bullet lists:

Each item of a list should start with a * or - and 2 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 two 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.