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 it

  • Lists 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.