The smallest useful Markdown table
A Markdown table has a header row, a separator row, and one or more rows of content. Pipe characters separate the cells. The separator tells the renderer that the lines form a table.
| Work | Owner | Status | | --- | --- | --- | | Outline | Ada | Ready | | Review | Sam | Next |
The source columns do not need to line up perfectly with spaces. Keep the number of cells consistent, and let the renderer draw the grid. Leading and trailing pipes make the source easier to scan even where a renderer treats them as optional.
Tables are a common Markdown extension rather than part of the original core syntax. When a table needs to travel to another system, check that system's Markdown support.
Align a column with colons
The separator row also controls alignment. Put a colon at the left for left alignment, at both ends for centered content, or at the right for right alignment:
| Item | State | Count | | :--- | :---: | ---: | | Notes | Ready | 12 | | Drafts | Review | 3 |
Left alignment usually suits prose. Right alignment helps readers compare numbers. Centering can work for short labels, but longer sentences become harder to scan when each line begins in a different place.
Prefer a small table with a clear purpose over a wide grid that forces the reader to scroll repeatedly.
Edit the structure visually in Beauty
Beauty gives table structure controls a place in the document. You can add or remove rows and columns, set alignment, move a column, and adjust its display width. Tab moves between cells while you work.
Moving a column should move the associated values with its heading. The animation shows that relationship by keeping each column together during the transition. In a real note, check the heading and the first few values after any structural change.
Column widths are a presentation preference. Ordinary Markdown table syntax does not carry pixel widths, so another editor may lay out the same table differently. Use a PDF export when a reader needs a fixed document layout.
Handle punctuation and longer content
If a cell contains a literal pipe, escape it so it is not mistaken for a new cell separator:
| Expression | Meaning | | --- | --- | | a \| b | Either option |
Keep paragraphs and complex nested structures outside a table where possible. Markdown tables are best for short, comparable values: a name, an owner, a status, an amount. Long explanations are usually clearer as headings and paragraphs beneath the grid.
When pasting a table from another app, inspect the result before relying on it. Merged cells and rich formatting do not always have an equivalent in Markdown.
Use a table when the columns earn their place
A table is useful when every row answers the same questions. For meeting actions, those questions might be “what,” “who,” and “when.” The meeting notes template uses exactly that structure.
For a short list of unrelated thoughts, bullets are simpler. For connections between stages, a Mermaid diagram may explain the relationship more clearly. Choose the smallest structure that helps the reader.