Docs

Lists

Ordered, unordered, nested, and task lists

Unordered lists

Start each item with -, *, or + (pick one and stay consistent; - is the house style):

Result
  • Real numbers
  • Complex numbers
    • Purely imaginary
    • With nonzero real part
Markdown
- Real numbers
- Complex numbers
  - Purely imaginary
  - With nonzero real part

Indent nested items by two spaces (aligned under the parent's text).

Ordered lists

Result
  1. State the claim
  2. Prove the base case
  3. Prove the induction step
Markdown
1. State the claim
2. Prove the base case
3. Prove the induction step

Only the first number matters – 1. / 1. / 1. renders as 1, 2, 3, which keeps diffs clean when you reorder items. A different first number starts the list there (3. begins at 3).

Task lists

Result
  • Draft the introduction
  • Collect the references
Markdown
- [ ] Draft the introduction
- [x] Collect the references

The checkboxes are display-only on a published page.

Blocks inside list items

A list item can hold paragraphs, code blocks, display math, or a nested list. Indent the continuation to align with the item's text:

Result
  1. Compute the integral:

  2. Substitute the result.

Markdown
1. Compute the integral:
 
   $$
   \int_0^1 x^2 \, dx = \tfrac{1}{3}
   $$
 
2. Substitute the result.

A blank line between items makes the list "loose" – each item is wrapped in its own paragraph with more vertical space. Without blank lines the list stays tight. Mixing the two in one list renders it all loose.