Lists in the old editor

Warning

For information on how to work with lists in the new editor, see Formatting text.

Numbered list

List with numbers

  • Before each item in the list, add a number with a dot and a space.

    Note

    The numbering of the list starts with the number that you put before the first item. The order of the numbers in the markup does not affect the numbering of the finished list, but it is more convenient to use the source text if the list items are numbered consecutively.

  • To create a second-level list item, add three spaces at the beginning of the line.

  • To skip the numbering steps, put # after the number with a dot and the number that the numbering starts with will continue.

  • Separate the list from the following text with an empty line.

Markup:

1. List item
2. List item
    1. Nested list item
    2. Nested list item
    3. Nested list item
3.#8 Item after skipping items in the numbering sequence
4. Ninth item of the list

List with letters

  • A list with letters is created in the same way as a numbered list, except that it uses Latin letters instead of numbers.

  • To create a list with Roman numerals, add the letter I or i before each list item with a dot and a space.

  • Lists with letters do not support skipping numbering steps using the # symbol.

Markup:

List with capital letters:
A. List item
B. List item

List with lowercase letters:
a. List item
b. List item

List with lowercase letters:
I. List item
I. List item

Bulleted list

  • Insert a marker symbol before each item in the bulleted list. You can use -, *, or + as markers.
  • To create a second-level list item, add two spaces at the beginning of the line.
  • Separate the list from the following text with an empty line.

Markup:

* List item
* List item
    * Nested list item
    * Nested list item
* List item

Combined list

You can include a bulleted sub-list into your numbered list and vice versa:

1. Ordered list item
2. Ordered list item
    * Bulleted nested list item
    * Bulleted nested list item
1. Ordered list item

Block elements inside a list

To ensure that cut titles, quotes, code blocks, tables, and other elements nested in the list are displayed correctly, make a left indent of four spaces in front of them relative to the list marker:

1. item 1
    <[Quote with a list
    1. text
    1. text
    1. text
    ]>
1. item 2

To-do lists

A to-do list (checklist) is a numbered or bulleted list where you can mark completed items. To create a to-do list, add a space and the following characters after the number or bullet in each item:

  • [] for an unmarked item.

  • [x] for a marked item.

  • Numbered list

    1. [x] Checked item
    2. [] Unchecked item
    3. [] Unchecked item
    
  • Bulleted list

    + List item
    - [x] Checked item
    - [] Unchecked item