Tables

To add a table:

  1. On the toolbar, click Table.

    You can also use the quick access menu: type / and select a command from the list.

  2. To add rows or columns, hover over the table and click next to its right or bottom edge.

  3. Fill in the cells. You can format text in the table cells.

To edit a table, select a cell and use the buttons above the column or at the beginning of the row. You can:

  • Add rows or columns before or after the current cell.

  • Delete the selected row or column.

  • Delete a table.

Multi-row tables allow you to add multi-row content such as lists, code snippets, and other tables to a single cell.

Simple table cells can only contain inline formatting elements: text formatting, images, and links. In addition, simple tables support left-aligned, right-aligned, and centered cell text.

Note

Simple tables can only be added in Markdown mode.

You can convert a simple table into a multi-row table in the visual editor. To do this, select a table cell, click , and choose Convert to YFM table.

Multi-row table

To add a multi-row table, use the following markup:

#|
|| **Header 1** | **Header 2** ||
||Two lines
of text
|
- Item 1
- Item 2
- Item 3
||
|#

Tip

To highlight the header row in the table, you can apply formatting to the text in the first row. For example, you can make it bold.

Result

Header 1

Header 2

Two lines
of text
  • Item 1
  • Item 2
  • Item 3

Simple table

To insert a basic table into your text, use the following markup:

| Header 1 | Header 2 | Header 3 |
| --- | --- | --- |
| cell 11 | cell 12 | cell 13 |
| cell 21 | cell 22 | cell 23 |
Result
Header 1 Header 2 Header 3
cell 11 cell 12 cell 13
cell 21 cell 22 cell 23

Aligning text

In basic tables, you can left-align, right-align, and center the contents of a column. To do this, use colons (:) in the table's separator row.

| Left-aligned | Centered     | Right-aligned |
| :---           | :----:        | ---:            |
| Text          | Text         | Text           |
| Text          | Text         | Text           |
Result
Left-aligned Centered Right-aligned
Text Text Text
Text Text Text
Previous
Links
Next
Embedded object (iframe)