ComponentsLists and Tables
Components

Lists and Tables

Reference for creating ordered lists, unordered lists, nested lists, and tables in MDX.

Overview

Organize information with ordered lists, unordered lists, and tables. All standard Markdown list and table syntax is supported.

Lists

Ordered lists

Use numbers followed by periods:

1. First item
2. Second item
3. Third item
  1. First item
  2. Second item
  3. Third item

The actual numbers don't matter; Markdown automatically sequences them. You can use 1. for all items.

Unordered lists

Use dashes (-), asterisks (*), or plus signs (+):

- First item
- Second item
- Third item
  • First item
  • Second item
  • Third item

Nested lists

Indent items with spaces (typically 2 or 4 spaces):

1. First item
   - Nested unordered item
   - Another nested item
2. Second item
   1. Nested ordered item
   2. Another nested ordered item
3. Third item
  1. First item
    • Nested unordered item
    • Another nested item
  2. Second item
    1. Nested ordered item
    2. Another nested ordered item
  3. Third item

Mixing different list markers (-, *, +) in the same list can cause inconsistent rendering.

Tables

Use pipes (|) to separate columns and dashes (-) to create headers:

| Feature | Description | Status |
|---------|-------------|--------|
| Authentication | User login system | Complete |
| Dashboard | Main user interface | In progress |
| Reports | Data analytics | Planned |
FeatureDescriptionStatus
AuthenticationUser login systemComplete
DashboardMain user interfaceIn progress
ReportsData analyticsPlanned

Table formatting

Raw Markdown doesn't need to align perfectly, but it improves readability:

| Name | Role | Status |
|---|---|---|
| Alice | Developer | Active |
| Bob | Designer | Inactive |
NameRoleStatus
AliceDeveloperActive
BobDesignerInactive

Common patterns

  • Sequential content - Ordered lists for steps, procedures, rankings
  • Related items - Unordered lists for features, requirements, options
  • Structured data - Tables for comparisons, specifications, status tracking
  • Hierarchical information - Nested lists with consistent 2 or 4-space indentation