Lists & Tables

Use lists to organize steps or ideas. Use tables to compare values across consistent columns.

Weekend Plan
  1. Choose a destination.
  2. Book train tickets.
  3. Pack a day bag.
  • Weather: Sunny
  • Budget: Medium
ItemEstimate
Train tickets45
Lunch18
## Weekend Plan 1. Choose a destination.2. Book train tickets.3. Pack a day bag. - Weather: Sunny- Budget: Medium | Item | Estimate || --- | ---: || Train tickets | 45 || Lunch | 18 |

Lists

Unordered lists

Use unordered lists when sequence does not matter.

  • Apples
  • Bananas
  • Bread
- Apples- Bananas- Bread

Ordered lists

Use ordered lists when readers should complete items in sequence.

  1. Fill a kettle with water.
  2. Heat until boiling.
  3. Pour over tea leaves.
1. Fill a kettle with water.2. Heat until boiling.3. Pour over tea leaves.

Nested lists

Use nested lists to add sub-steps or grouped details.

  1. Plan dinner
  • Pick a main dish
  • Pick a side dish
  1. Shop for ingredients
  • Check pantry first
1. Plan dinner  - Pick a main dish  - Pick a side dish2. Shop for ingredients  - Check pantry first

Tables

Basic tables

Use tables when each row shares the same fields.

MovieGenreRuntime
Moonrise KingdomComedy94 min
ArrivalSci-fi116 min
Spirited AwayAnimation125 min
| Movie | Genre | Runtime || --- | --- | --- || Moonrise Kingdom | Comedy | 94 min || Arrival | Sci-fi | 116 min || Spirited Away | Animation | 125 min |

Alignment

Use alignment markers in the separator row when readability depends on numeric or status columns.

ItemPriceIn stock
Bread3.50Yes
Olive oil9.25Yes
Basil1.80No
| Item | Price | In stock || :--- | ---: | :---: || Bread | 3.50 | Yes || Olive oil | 9.25 | Yes || Basil | 1.80 | No |

Formatting inside cells

Use inline formatting in table cells for clarity, but keep it minimal.

StyleExample
Inline code2 tbsp sugar
EmphasisImportant
LinkFarmers market
| Style | Example || --- | --- || Inline code | `2 tbsp sugar` || Emphasis | **Important** || Link | [Farmers market](https://example.com) |