Download for PHP  R515 (beta)
Welcome » Lists
Expand

Input document

.

Upload document:

Lists

Full reference: Lists
To define a list start each line with at least 2 spaces (4, 6, etc. for deeper nesting), then put desired list marker and at least one space after it.

A list ends once there are not enough leading spaces (3-5-7-… spaces are rounded down to 2-4-6-… – similar to Indentation) or there’s another block markup following.

Ordered lists

…can be of 6 types:

  1. Normal numerical list;
  2. Zero-padded numerical list;
  3. Lower-Latin-alpha list (a-n);
  4. Upper-Latin-alpha list (A-N);
  5. Lower-Roman-alpha list (up to 5 combinations of i, v and x);
  6. Upper-Roman-alpha list.

To make maintaining large lists easier there’s a convention: if list item’s value is the same as its previous sibling it’s incremented by 1. This allows you avoiding re-enumerating the list after adding new items, removing old ones or just moving them around.

It works for two numerical markers only.

  1. First item;
  2. Second item.
  1. First item, zero-padded;
  2. Second item;
  3. Third item.

Unordered lists

…can be of 3 types:

  • Normal bullets;
  • Squares;
  • Circles.

Exact view depends on the template used – for example, last type (dash) can be used to show dialogues.

Associative lists

Such lists are commonly used to define list of terms, glossary or dictionary entries. They’re defined similarly to Terms – term name is separated from its caption with dual equality signs (==) or, if there is none, with a space.

In HTML they are rendered as <dt>, <dt>, <dd> tags.

Term 1
Description, any markup is supported.
Spaceless
Term description.

Nesting

Lists can be nested and can contain mixed markers:

  • first bullet item;
  • Second Roman item;
    1. Nested numerical item;
    2. Second one;
      • More nesting.
  • Back to the main list;
    Nested
    associative list;
    Another
    term;

Line breaks

If you put a line break in a list item this won’t close the list if there are more leading spaces than required by the list of given nesting level.

  • item 1;
  • item 2, continues… …here;
  • item 3 of the same list;

This line is a new indented paragraph.

  • item 1 of the second list.

Languages