Skip to content

Work with tables

Tables are useful for reference data, comparison matrices, and structured information.

Insert a table

  1. Type / and select Table, or click the table button in the toolbar.

  2. 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 row above / Add row below: insert a row relative to the current one

  • Delete row: removes the current row

  • Add column left / Add column right: insert a column relative to the current one

  • Delete column: removes the current column

  • Toggle header row: marks the first row as a header (bold text, distinct background)

  • Merge cells: select multiple cells and merge them into one

  • Split cell: splits a merged cell back into separate cells

  • 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 are required for accessibility: screen readers use header cells to announce column context.

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: bold, italic, inline code, and links. Keep cell content short. Tables are for scannable reference data, so move long procedures or code samples out of cells into the surrounding topic.

See also

Was this page helpful?