# Markdown table

How to write a Markdown table with pipes and hyphens, align its columns with colons and put a pipe inside a cell, with examples to copy.

**Definition:** A Markdown table is a grid written in plain text, with pipes (|) between the columns and a row of hyphens under the header row, that a Markdown app shows as a formatted table.

## How to write one

Write the header row, then a row of hyphens, then one line per row. Pipes separate the columns:

```markdown
| Issue | Topic        | Status |
| ----- | ------------ | ------ |
| 41    | Pricing page | Sent   |
| 42    | Agent undo   | Draft  |
```

The header row and the hyphen row need the same number of cells, or the table doesn't form and the lines show as plain text. Leave a blank line before the table, and end it with a blank line.

## Align a column

Put a colon on the left of the hyphens to align a column left, on the right to align it right, or on both sides to center it:

```markdown
| Left | Center | Right |
| :--- | :----: | ----: |
| a    | b      | 1.50  |
```

## A pipe inside a cell

A pipe ends a cell, so type a backslash before one you want to show: `\|`.

## Where tables work

Tables aren't in the original Markdown syntax. They come from GitHub Flavored Markdown, so GitHub and apps that follow it show them as tables, and an app that follows only the original syntax shows the pipes as text.

## In Flywrite

In Rendered view, Flywrite shows a Markdown table as a formatted table. Click a cell to edit: the table switches back to its pipes, set in a monospace font so the columns line up, and shows as a table again when you move out of it. The file keeps the plain pipe text.

## Questions

### Do the pipes have to line up?

No. Cells in a column can be different widths, and the pipes at the start and end of each row are optional. Lining them up only makes the plain text easier to read.

### Can a table cell hold a list?

No. A cell holds one line of text, which can include bold, italic, code and links. Lists, headings and other blocks can't go inside a table.

## Sources

1. [GitHub Flavored Markdown Spec](https://github.github.com/gfm/), checked 2026-11-10
2. [GitHub Docs: Organizing information with tables](https://docs.github.com/en/get-started/writing-on-github/working-with-advanced-formatting/organizing-information-with-tables), checked 2026-11-10

---

This is the Markdown copy of https://flywrite.app/glossary/markdown-table.
