Skip to content
Markdown for AI

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 AI reads it better

Section titled “Why AI reads it better”

When the pipes line up, a language model parses rows and columns as real relationships. Flatten the same data into prose and the model has to guess which number belongs to which metric.