Lists - Furo

Furo is under active development, and this documentation is not written yet!

# Lists

Lists are useful because they emphasize certain information in regular text. They can able be used to enumerate or provide an easier reference. Sphinx allows for various forms of lists, each of which can be used in a different manner.

## Bullet Lists

reStructuredText

    - Bullet lists in reStructuredText are fairly straightforward.
    - A bunch of bullet points.

      - Nested bullets should be indented by **exactly** two spaces.
      - They also need a blank line before and after them, otherwise it doesn't
        work right.

    - It is also possible to have multiple paragraphs in a bullet.

      Make sure to have a blank line between the paragraphs, and to indent the
      paragraphs to the correct level.

- Bullet lists in reStructuredText are fairly straightforward.

- A bunch of bullet points.

  - Nested bullets should be indented by exactly two spaces.

  - They also need a blank line before and after them, otherwise it doesn’t work right.

- It is also possible to have multiple paragraphs in a bullet.

  Make sure to have a blank line between the paragraphs, and to indent the paragraphs to the correct level.

Markdown (MyST)

    - Bullet lists in Markdown are pretty straightforward.
    - A bunch of bullet points.
      - Nested bullets should be indented by two or more spaces.
      - They can just "show up" inline with the rest of the list. Adding blank lines
        before and after is also permitted.
    - It is also possible to have multiple paragraphs in a bullet.

      Make sure to have a blank line between the paragraphs, and to indent the
      paragraphs to the correct level.

- Bullet lists in Markdown are pretty straightforward.

- A bunch of bullet points.

  - Nested bullets should be indented by two or more spaces.

  - They can just “show up” inline with the rest of the list. Adding blank lines before and after is also permitted.

- It is also possible to have multiple paragraphs in a bullet.

  Make sure to have a blank line between the paragraphs, and to indent the paragraphs to the correct level.

## Numbered Lists

reStructuredText

    1. Numbered lists are not complicated.
    2. They do exactly what you think they do.

1. Numbered lists are not complicated.

2. They do exactly what you think they do.

Markdown (MyST)

    1. Numbered lists are not complicated.
    2. They do exactly what you think they do.

1. Numbered lists are not complicated.

2. They do exactly what you think they do.

## Definition Lists

reStructuredText

    Definition Lists
       An extremely useful tool for describing stuff.

    Complicated Term
       Definition

Definition Lists

  An extremely useful tool for describing stuff.

Complicated Term

  Definition

Markdown (MyST)

    Definition Lists
    :  An extremely useful tool for describing stuff.

    Complicated Term
    :  Definition

Definition Lists

  An extremely useful tool for describing stuff.

Complicated Term

  Definition