---
title: Table forms
---
# Ways to make a table
This renderer builds tables from Markdown **pipe tables** (optionally wrapped
in a `table` tag for styling), shown below. The Markdoc **list-syntax** table
(cells as `*` items separated by `---`) is also supported — see
`table-list-syntax`.
## Basic table
A plain pipe table. The first row is the header.
| Heading 1 | Heading 2 |
|--------------|--------------|
| Row 1 Cell 1 | Row 1 Cell 2 |
| Row 2 Cell 1 | Row 2 Cell 2 |
## Table without a header
Leave the header row blank (`| | |`) and it is dropped, leaving a plain grid.
| | |
|------|------|
| foo | bar |
| foo | bar |
## Header column (row headers)
Write the table as a list-syntax `table` tag with `header_column=true` to
turn the first column into row headers (bold + shaded).
{% table header_column=true %}
---
* Date
* 2026-05-20
---
* Version
* 3.9.0
---
* Author
* Acme
{% /table %}
## Text alignment
Use CommonMark column markers in the delimiter row — `:---` left,
`:--:` centre, `---:` right.
| Left | Centre | Right |
|:------------|:------:|------:|
| foo | bar | baz |
| another row | mid | 1,234 |
| x | y | 42 |