Markdown Table Builder
Convert TSV / CSV / pipe-separated data into a Markdown table.
Overview
Paste tabular data — TSV from a spreadsheet, CSV from a database export, or plain pipe-separated text — and the builder converts it into a properly formatted Markdown table with header row, alignment markers, and padded columns. The output drops cleanly into any GFM-compatible Markdown.
Technical writers documenting API parameters, bloggers presenting comparison charts, README authors listing supported platforms, and analysts moving data from spreadsheets into docs all reach for this. Hand-formatting Markdown tables is painful; this tool gets it right in one pass.
How it works
The builder sniffs the delimiter automatically (tab, comma, pipe, semicolon) or accepts an explicit choice. The first row becomes the header. Each column's width is set to the longest cell so the source Markdown stays readable, and you can specify left, right, or center alignment per column via the second row of the output (:---, ---:, :---:). Cells containing pipes are escaped with \| so they don't break the table.
Examples
Input (TSV):
Name Score Status
Alice 95 Pass
Bob 72 Pass
Carol 58 Fail
Output:
| Name | Score | Status |
|-------|-------|--------|
| Alice | 95 | Pass |
| Bob | 72 | Pass |
| Carol | 58 | Fail |
FAQ
Which Markdown flavors support tables?
GitHub Flavored Markdown (GFM), CommonMark with the GFM extension, and most other modern Markdown processors. Pure CommonMark doesn't include tables in its base spec.
Can I align columns?
Yes. Use :--- for left (default), ---: for right (typical for numbers), and :---: for center. The builder offers a per-column alignment picker.
What if a cell contains a pipe character?
The builder escapes it as \| so the table doesn't break. Multi-line cells aren't supported by the GFM table syntax — use HTML if you need them.