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... |
SymbolNameValue
Pi3.14159...
Euler's number2.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     |
LeftCenterRight
abc

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.