How to make a Markdown table
Build a clean Markdown table without counting pipes by hand — paste your data, set the alignment, and copy a perfectly formatted table.
Markdown tables are simple to read and miserable to type. One missing pipe and the whole table collapses into a line of text. The Markdown Table Generator builds the table for you, so you never count | characters again.
The syntax, and why it's fiddly
A Markdown table is pipes and dashes:
| Name | Role |
| ---- | ----- |
| Ada | Eng |
The second row — the dashes — is mandatory and defines the columns. Get the pipe count wrong on any row and the renderer gives up. Typing this by hand for anything past two columns is where mistakes creep in.
A faster way
- Enter or paste your data — rows and columns.
- Set each column's alignment (left, center, or right).
- Copy the generated Markdown.
The output is correctly padded and aligned, valid on GitHub and everywhere else.
Column alignment
The dashes row controls alignment with colons:
:---left-aligned:--:centered---:right-aligned (great for numbers)
Right-aligning numeric columns makes them line up by place value, which is far easier to scan.
Keeping tables readable in source
Even a valid table can be ugly in raw form if the columns aren't padded to equal width. If you've hand-edited a table and it's become ragged, the Markdown Table Formatter re-aligns every column in one pass.
When a table isn't the answer
Tables are for comparable data across rows — specs, results, options. If you're really making a list, a bulleted list reads better and survives narrow screens, where wide tables overflow. Use a table when the columns earn their keep.
Build the table, copy it, and move on with your document.