Ordered lists group related items and mark them with ascending counters. They provide a very clear structure but are tedious to read when they get too long. Consider to insert a normal paragraph or another block element in between the items of a long list.

Syntax

List items begin with an integer followed by a period and a space. The order of the numbers has no effect on the result, we even may use always the same number. Markdown treats the numbers as markers and ignores their values. Every list or sub-list will follow 1, 2, 3…, a, b, c… or I, II, III… .

It’s possible to manipulate the counters with attributes. The one currently available is .ol-continue and lets us continue to start a new list where the last one did end (see With Interruption).

Layout

Only two layout examples are following here, because the styling options for an ordered list are basically the same as for an unordered bullet list.

Tight List

  1. First item
  2. Second item
  3. Third item

Nested Loose List with interruption

  1. Far far away, behind the word mountains, far from the countries Vokalia and Consonantia, there live the blind texts. Separated they live in Bookmarksgrove right at the coast of the Semantics, a large language ocean. A small river named Duden flows by their place and supplies it with the necessary regelialia.

    1. Far far away, behind the word mountains, far from the countries Vokalia and Consonantia, there live the blind texts.

    2. Far far away, behind the word mountains, far from the countries Vokalia and Consonantia, there live the blind texts.

  2. Far far away, behind the word mountains, far from the countries Vokalia and Consonantia, there live the blind texts.

    Separated they live in Bookmarksgrove right at the coast of the Semantics, a large language ocean. A small river named Duden flows by their place and supplies it with the necessary regelialia.

The interruption

of an ordered list for a general remark should not interrupt the counting, we need to go on afterwards where we left. The class attribute {.ol-continue} lets a list continue, where the previous did stop.

  1. Far far away, behind the word mountains, far from the countries Vokalia and Consonantia, there live the blind texts.

    1. Far far away, behind the word mountains, far from the countries Vokalia and Consonantia, there live the blind texts.

      1. Far far away, behind the word mountains, far from the countries Vokalia and Consonantia, there live the blind texts.

      2. Far far away, behind the word mountains, far from the countries Vokalia and Consonantia, there live the blind texts.

      3. Far far away, behind the word mountains, far from the countries Vokalia and Consonantia, there live the blind texts.

      4. Far far away, behind the word mountains, far from the countries Vokalia and Consonantia, there live the blind texts.

    2. Far far away, behind the word mountains, far from the countries Vokalia and Consonantia, there live the blind texts.

      Separated they live in Bookmarksgrove right at the coast of the Semantics, a large language ocean. A small river named Duden flows by their place and supplies it with the necessary regelialia.

      It is a paradisematic country, in which roasted parts of sentences fly into your mouth. Even the all-powerful Pointing has no control about the blind texts it is an almost unorthographic life.

  2. Far far away, behind the word mountains, far from the countries Vokalia and Consonantia, there live the blind texts.