6.15 Lists

Basic lists

1. ordered list
2. item 2
   i) sub-item 1
      A. sub-sub-item 1

Will be rendered as:

  1. ordered list
  2. item 2
    1. sub-item 1 A. sub-sub-item 1

Quarto uses Pandoc’s Markdown, which supports a variety of ordered list types, including:

  • numbers: 1. 2. 3.
  • letters: a. b. c. or A. B. C.
  • roman numerals: i. ii. iii. or I. II. III.

These list markers / labels need to be followed by a period and a space. Optionally, list markers may be enclosed in parentheses or followed by a single right-parentheses or period.

Special list marker @ can be used for sequentially numbered examples. The benefit of using @ is that when the list is broken up by other content, the numbering will continue correctly.

(@)  My first example will be numbered (1).
(@)  My second example will be numbered (2).

Explanation of examples. ← This breaks list structure.

(@)  My third example will be numbered (3).

Q: How to start numbering at a number other than 1?
A: Simply explicitly restart the list at the number you want.

1. item 1
1. item 2

Code block


3. item 3
1. item 4

will be rendered as:

  1. item 1
  2. item 2
Code block
  1. item 3
  2. item 4

ref: https://stackoverflow.com/a/78497776