Tables
Syntax
A header row, a delimiter row, then data rows, with columns separated by |:
| Symbol | Name | Value |
|--------|------|-------|
| $\pi$ | Pi | 3.14159... |
| $e$ | Euler's number | 2.71828... || Symbol | Name | Value |
|---|---|---|
| Pi | 3.14159... | |
| Euler's number | 2.71828... |
The columns do not need to line up in the source – |---|---| is enough –
but aligned source is easier to edit. Leading and trailing pipes are optional;
keep them for readability.
Alignment
Colons in the delimiter row set column alignment:
| Left | Center | Right |
|:-----|:------:|------:|
| a | b | c || Left | Center | Right |
|---|---|---|
| a | b | c |
Numbers usually read best right-aligned.
Cell content
Cells hold inline content: emphasis, code, links, inline math. To show a
literal pipe inside a cell, escape it as \|.
What cells cannot hold: line breaks, lists, or any block content. If a cell
wants a paragraph, the content has outgrown a Markdown table – restructure,
or fall back to a raw HTML <table>
(within the allowed HTML).
Wide tables scroll horizontally on narrow screens rather than breaking the page layout.