Work with tables
Tables are useful for reference data, comparison matrices, and structured information.
Insert a table
Type
/and select Table, or click the table button in the toolbar.A 3x3 table appears. Click any cell to start typing.
Edit table structure
Click inside a table to reveal the table toolbar at the top of the table:
Add column — inserts a column to the right
Add row — inserts a row below
Remove column — deletes the current column
Remove row — deletes the current row
Toggle header row — marks the first row as a header (bold text, distinct background)
Merge cells — select multiple cells and merge them into one
Delete table — removes the entire table
Always toggle the header row on for tables that have column labels. Headers improve readability in the editor and on Publish a web site, and they're required for accessibility — screen readers use header cells to announce column context.
Navigate between cells
Action | Shortcut |
|---|---|
Move to next cell | Tab |
Move to previous cell | Shift+Tab |
Move between cells at edge | Arrow keys |
Tips
Toggle the header row for tables that have column labels — this improves readability in both the editor and on published sites.
Tables are fully responsive on published sites. On narrow screens, they scroll horizontally.
For very large reference tables, consider splitting the data across multiple smaller tables under separate headings.
Tables support inline formatting inside cells — you can use bold, italic, inline code, and links within table cells. However, block-level elements like lists, code blocks, and callouts cannot be nested inside table cells.
See also
Format content in the editor — Full overview of editor formatting options
Use slash commands — Insert tables and other blocks from the keyboard
Keyboard shortcuts — Tab, Shift+Tab, and other navigation shortcuts
Published site features — How tables render on published sites