Tables in the Markdown editor let you organize and present data in a structured, readable format, which is useful for comparing features, listing options, or summarizing information. There are two ways to create a table: using the Insert table toolbar icon, or typing the Markdown table syntax manually.
These steps apply to the Markdown editor and to Markdown view in the unified Editor. The Markdown table syntax renders the same way in both.
NOTE
The unified Editor is rolled out in phases and is currently available in projects created after November 16, 2026. Projects created earlier continue to use the Advanced WYSIWYG editor and the Markdown editor. We're working to make it available to all projects soon.
When to use tables
- Feature comparisons: display differences between plans, options, or configurations side by side.
- Reference data: list parameters, field names, or settings with their descriptions in a structured format.
- Structured summaries: present data sets where rows and columns make relationships between values immediately clear.
The Markdown table syntax described here applies to Markdown content. Tables themselves are available in every editor. In the unified Editor's Block view, select Insert table in the toolbar or type /table. In the Advanced WYSIWYG editor, select Insert Table in the toolbar. See Tables.
Quick reference
Markdown table syntax
| Column 1 | Column 2 | Column 3 |
|:-------- |:--------:| --------:|
| Left | Center | Right |
Column alignment
| Syntax | Alignment |
|---|---|
:--- |
Left |
:---: |
Center |
---: |
Right |
Limits
| Item | Value |
|---|---|
| Maximum columns (Markdown editor toolbar) | 10 |
| Maximum rows (Markdown editor toolbar) | 15 |
| Header row required | Yes. Markdown tables always require a header row |
How to create a table in Markdown
Using the toolbar (Markdown editor)
-
Open the desired article in the Markdown editor in the Knowledge base portal.
-
Click the Insert table () icon in the editor toolbar.
An interactive grid appears.
-
Drag to select the number of rows and columns you need. You can select up to 10 columns × 15 rows.

-
To add more rows beyond the initial selection, move to a new line below the table and enter cell content using vertical pipes (
|) to separate each column. Each new line represents a row.Example:
| Basic | Yes | Limited | Like | | Pro | Yes | Full | Dislike |
Typing manually
-
Open the desired article in the Markdown editor, or select Markdown view (</>) in the article header in the unified Editor.
-
Type vertical pipes (
|) and hyphens (-) to define the table structure. Use colons (:) in the separator row to set column alignment.Sample code:
| Column 1 | Column 2 | Column 3 | |:-------- |:--------:| --------:| | Left | Center | Right | -
The separator row (second line) is required. Without it, the content will not render as a table.
In the unified Editor, a table you create in Markdown view has Fit table to page width turned on by default, so it spans the full width of the page with columns of equal width. To turn it off, add fit-width="false" to the table marker, or switch to Block view and turn off Fit table to page width from the table's Display menu. To learn more, see Edit a table in Markdown view.
Outcome:

How to create a table without a header row
Standard Markdown always requires a header row. In the Markdown editor, if you need a table without a visible header, use HTML <table> syntax instead:
<table>
<tr>
<td>Row 1</td>
<td>Value 1</td>
</tr>
<tr>
<td>Row 2</td>
<td>Value 2</td>
</tr>
</table>
Add more <tr> blocks for additional rows and more <td> cells within each row for additional columns, following the same structure.
Output:

In the unified Editor's Markdown view, keep the Markdown table and add header="none" to the table marker instead. The first row then displays as a normal row. See Tables.
Best practices
- Always include a header row: even if the column names are generic (Column 1, Column 2), a header row makes the table easier to scan and is required for standard Markdown syntax.
- Keep cell content concise: long text in cells makes tables hard to read. If a cell needs more than a sentence, consider using a list or paragraph instead.
- Use alignment intentionally: left-align text columns, right-align numeric columns, and use center alignment sparingly for labels or status values.
- Use the toolbar for quick tables: the Insert table icon is the fastest way to create a standard table. Switch to manual syntax when you need precise control over alignment or are adding rows beyond the 15-row toolbar limit.