Tables in Markdown
Basic syntax
Section titled “Basic syntax”A table is just pipes and dashes: a header row, a divider of hyphens, then your data. Colons in the divider set column alignment.
| Metric | Q2 | Q3 ||:----------|-----:|-----:|| Retention | 91% | 95% || Churn | 2.4% | 2.1% || Metric | Q2 | Q3 |
|---|---|---|
| Retention | 91% | 95% |
| Churn | 2.4% | 2.1% |
Why explicit structure can help
Section titled “Why explicit structure can help”Pipes and header labels make the intended row and column boundaries explicit. That can reduce ambiguity compared with flattening the same data into prose, but it does not guarantee that a model will preserve every relationship. Test complex tables with representative data in the converter, editor, or AI tool you plan to use.
