Lists and Tables

Overview

You can add lists and tables in two ways:

• Editor UI – Use the slash (/) menu and on-table controls.

• MDX/Markdown – Type list and table syntax directly.

All standard Markdown list and table syntax is supported.

Lists

Create lists with the editor UI

1. Place your cursor on a new line.

2. Type / to open the block menu.

3. Under Lists & Formatting, choose:

   • Bullet List

   • Numbered List

Then:

• Start typing your first item.

• Press Enter to create the next item.

• Press Tab to create a nested list under the current item.

You can switch an existing block to a list (or back to a paragraph) using the block dropdown on the left.

Create lists with MDX syntax

Ordered lists

Use numbers followed by periods:

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

• First item

• Second item

• Third item

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

Tables

Create and edit tables with the editor UI

1. Place your cursor on a new line.

2. Type / to open the block menu.

3. Select Table.

A basic table will be inserted:

• The first row is the header row. Text in this row is styled as headings (bold).

• From the second row onward, you can enter regular cell content.

Row controls

Hover near the left edge of a row to reveal the row toolbar:

• H – Toggle header row on/off for that row.

• Up/Down arrows – Move the current row up or down.

• Trash (when present) – Remove the row.

You can use this to:

• Turn an existing content row into a header row.

• Demote a header row back to a regular row.

• Reorder rows without copying/pasting.

Column controls

Hover over the top of a column to reveal the column toolbar (three-dot icon):

• Change the alignment of the column (left, center, or right).

• Use arrows to move the column left or right.

• Delete a column if needed.

Create tables with MDX syntax

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     |

Table formatting tips

Raw Markdown doesn’t need perfect alignment, but it improves readability:

| Name | Role      | Status  |
| ---- | --------- | ------- |
| Alice| Developer | Active  |
| Bob  | Designer  | Inactive|

Common patterns

• Sequential content: Use ordered lists for steps, procedures, and rankings.

• Related items: Use unordered lists for features, requirements, and options.

• Hierarchical information: Use nested lists to show levels of detail.

• Structured data: Use tables for comparisons, specifications, and status tracking.