---
title: "How to create tables in Markdown"
slug: "how-to-create-tables-in-markdown"
description: "Learn how to create tables in Markdown for better data organization and readability, enhancing your content with structured layouts."
updated: 2026-06-20T09:13:23Z
published: 2026-06-20T09:13:23Z
canonical: "docs.document360.com/how-to-create-tables-in-markdown"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.document360.com/llms.txt
> Use this file to discover all available pages before exploring further.

# How to create tables in Markdown

Tables in the Markdown editor let you organise and present data in a structured, readable format — useful for comparing features, listing options, or summarising information. There are two ways to create a table in the Markdown editor: using the **Insert table** toolbar icon, or typing the Markdown table syntax manually.

---

## 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.

 NOTE

Tables are only available in the **Markdown editor**. In the Advanced WYSIWYG editor, use the Insert menu to add a table block.

---

## Quick reference

### Markdown table syntax

```
| Column 1 | Column 2 | Column 3 |
|:-------- |:--------:| --------:|
| Left     | Center   | Right    |
```

### Column alignment

| Syntax | Alignment |
| --- | --- |
| `:---` | Left |
| `:---:` | Centre |
| `---:` | Right |

### Limits

| Item | Value |
| --- | --- |
| Maximum columns (via toolbar) | 10 |
| Maximum rows (via toolbar) | 15 |
| Header row required | Yes — Markdown tables always require a header row |

---

## How to create a table in Markdown

### Using the toolbar

1. Open the desired article in the Markdown editor in the Knowledge Base portal.
2. Click the **Insert table** (⊞) icon in the editor toolbar.

An interactive grid appears.
3. Drag to select the number of rows and columns you need. You can select up to **10 columns × 15 rows**.

![Markdown editor toolbar showing the Insert table icon and the interactive row and column selection grid.](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/1_ScreenShot-Markdown_tables.png)

1. 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

1. Open the desired article in the Markdown editor.
2. 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    |
```
3. The separator row (second line) is required. Without it, the content will not render as a table.

**Outcome:**

![Markdown editor showing a rendered table with three columns using left, centre, and right alignment.](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/2_ScreenShot-Markdown_tables.png)

---

## How to create a table without a header row

Standard Markdown always requires a header row. 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 `&lt;tr&gt;` blocks for additional rows and more `&lt;td&gt;` cells within each row for additional columns, following the same structure.

**Output:**

![HTML table rendered in the Markdown editor showing two rows with corresponding values and no header row.](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/1_Screenshot-Table_output_using_html_syntax.jpg)

---

## 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 centre 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.