Table structure
A basic table has three parts: column names, a separator, and rows of content.
- Use `|` between columns.
- Use `---` under each header.
- Keep the number of cells consistent across rows.
Syntax guide
Markdown Table
Markdown tables are compact, readable, and useful for simple structured data. The key is getting the separator row right.
Quick answer
A Markdown table needs a header row, a separator row, and one or more data rows. Pipes separate columns; hyphens in the second row tell the renderer where the header ends.
Reference
markdown table
Alignment and limits
Alignment markers work in many Markdown renderers, but tables are still meant for simple data.
- Use `:---` for left alignment.
- Use `:---:` for centered text.
- Use HTML tables if you need merged cells or complex layouts.
Examples
Copy-ready examples
Basic table
| Name | Role | Status |
| --- | --- | --- |
| Ada | Writer | Drafting |
| Lin | Reviewer | Ready |This is the most portable table pattern.
Aligned table
| Left | Center | Right |
| :--- | :---: | ---: |
| A | B | C |Alignment support depends on the renderer, so preview before publishing.
FAQ
Common questions
Why is my Markdown table not rendering?
Check the separator row. Each column needs a matching separator such as `---` directly under the header.
Do Markdown tables support merged cells?
Standard Markdown tables do not support merged cells. Use HTML when you need more complex table layouts.
Do I need spaces around pipes?
Spaces make tables easier to read, but the pipe characters and separator row are the important parts.