About this tool
Turns spreadsheet-style data into GitHub-flavored Markdown table syntax — the format used in READMEs, pull request descriptions, wikis, and most documentation tools. Columns are automatically padded so every row lines up, even if your source rows have different numbers of fields.
How to use the Markdown Table Generator
- Paste your data — copy straight from a spreadsheet (tab-separated) or paste CSV.
- Check the delimiter was detected correctly, and set alignment if you want it.
- Click "Generate table", then copy the Markdown into your README or doc.
Common use cases
- Turning a spreadsheet comparison into a table for a README or wiki page
- Building a Markdown table for a GitHub pull request description or issue
- Converting CSV export data into documentation without hand-typing pipe characters
Worked example
Pasting three rows of CSV data about command-line tools produces:
| Name | Language | Stars | | --- | --- | --- | | httpie | Python | 34000 | | fzf | Go | 64000 | | ripgrep | Rust | 49000 |
Any pipe character already present in your data (like a value containing "|") is automatically escaped to \| so it doesn't get mistaken for a column separator when the Markdown is rendered.
Things to watch out for
Markdown tables render best as plain text — a cell containing a line break is converted to <br>, which most Markdown renderers (including GitHub's) support, but a few plain-text viewers will show the literal tag instead. Column alignment in Markdown is a per-column property in the spec, but this tool applies one alignment to every column for simplicity; edit the divider row by hand afterward if you need mixed alignment.
Frequently asked questions
Yes — select "Tab" as the delimiter, or leave it on "Auto-detect", which counts commas, tabs, and pipes in the first line and picks whichever appears most.
It's automatically escaped as \| in the Markdown output, so it renders as a literal pipe inside a cell instead of being mistaken for a column boundary.
The Markdown table spec supports that, but this tool applies one alignment choice to every column to keep the interface simple. You can hand-edit the second (divider) line of the output afterward if you need mixed alignment.