Tables are used to present data and structured comparisons in rows and columns. Stencila Markdown supports simple pipe tables as well as richer table blocks with captions, labels, notes, and executable content.
For simple tables, use standard Markdown pipe-table syntax:
| A | B | C |
| --- | --- | --- |
| 1 | 2 | 3 |
| 4 | 5 | 6 |
Pipe tables can include empty cells:
| D | E |
| --- | --- |
| 1 | |
| | 2 |
Table cells can contain more than plain text, including inline formatting, code, and math:
| _Emphasized header_ | `Code header` |
| ----------------------- | --------------- |
| `Code inline` | **Strong cell** |
| `6 * 7`{python exec} | `2 \\pi r^2`{tex} |
| `Code with language`{r} | H~2~O |
| Emphasized header | Code header |
|---|
Code inline | Strong cell |
| 42 | |
Code with language | H2O |
You can specify horizontal alignment in the separator row:
| Left | Center | Right |
| :--- | :----: | ----: |
| L1 | C1 | R1 |
| L2 | C2 | R2 |
| Left | Center | Right |
|---|
| L1 | C1 | R1 |
| L2 | C2 | R2 |
To add a caption, label, and notes, wrap the table in a ::: table block:
::: table 3
The caption.
| A | B |
| --- | --- |
| 1 | 2 |
Some notes.
:::
Table 3: The caption.
| A | B |
|---|
| 1 | 2 |
As with figures, it is usually better to let Stencila manage labels automatically rather than assigning them manually.
Tables can also be generated from executable code, for example when the tabular output should stay in sync with analysis in the document.
For related authoring features, see:
For the formal Stencila Schema definitions behind these features, see:
