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.