Lists & Task Lists

Unordered Lists

Use -, *, or + as list markers:

- Item 1
- Item 2
  - Sub-item A
  - Sub-item B
- Item 3

• Item 1
• Item 2
  • Sub-item A
  • Sub-item B
• Item 3

Ordered Lists

1. First
2. Second
3. Third
   1. Sub-step A
   2. Sub-step B

1. First
2. Second
3. Third
   1. Sub-step A
   2. Sub-step B

Auto-Numbering

You can use 1. for every item — Markdown will auto-number them:

1. First
1. Second
1. Third

1. First
2. Second
3. Third

Start at a Different Number

5. Fifth item
6. Sixth item
7. Seventh item

5. Fifth item
6. Sixth item
7. Seventh item

Task Lists

Create interactive checklists with - [ ] (unchecked) and - [x] (checked):

- [x] Write the introduction
- [x] Add code examples
- [ ] Review and publish

• Write the introduction
• Add code examples
• Review and publish

Nested Content in Lists

Lists can contain paragraphs, code blocks, and other elements — indent by 4 spaces or 1 tab:

1. First item

   A paragraph inside the list item.

   ```python
   print("Code in a list")

2. Second item

1. First item

   A paragraph inside the list item.

   ```python
   print("Code in a list")

2. Second item

Definition Lists

Hugo supports definition lists via HTML:

<dl>
  <dt>Term</dt>
  <dd>Definition of the term.</dd>
</dl>

Term

Definition of the term.