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
- First item
- Second item
- 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
- First item
- Nested unordered item
- Another nested item
- Second item
- Nested ordered item
- Another nested ordered item
- 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 |
| Feature | Description | Status |
|---|---|---|
| Authentication | User login system | Complete |
| Dashboard | Main user interface | In progress |
| Reports | Data analytics | Planned |
Table formatting
Raw Markdown doesn't need to align perfectly, but it improves readability:
| Name | Role | Status |
|---|---|---|
| Alice | Developer | Active |
| Bob | Designer | Inactive |
| Name | Role | Status |
|---|---|---|
| Alice | Developer | Active |
| Bob | Designer | Inactive |
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