About the Markdown Table Generator
This Markdown table generator turns pasted comma or tab-separated data — copied straight from a spreadsheet or written by hand — into properly formatted Markdown table syntax, ready to drop into a README, wiki page or GitHub issue. It auto-detects whether your data is comma or tab-separated and lets you choose whether the first row is a header.
How to use the Markdown Table Generator
- 1
Paste your data, one row per line, with columns separated by commas or tabs.
- 2
Choose the delimiter, or leave it on auto-detect.
- 3
Toggle whether the first row is a header row.
- 4
Copy or download the generated Markdown table.
What people use it for
Turning a spreadsheet into a README table
Copy a range of cells from Excel or Google Sheets (which copies as tab-separated text) and paste it straight in to get a Markdown table for project documentation.
Formatting data for a GitHub issue or pull request
Quickly build a comparison table for a bug report or PR description without hand-typing pipe characters and alignment dashes.
Preparing a table for a static site or blog post
Generate clean Markdown table syntax for a Jekyll, Hugo or Next.js MDX post from a CSV export.
How Markdown table syntax works
A Markdown table is three parts: a header row with cells separated by pipe characters, a separator row of dashes marking where the header ends, and any number of data rows in the same pipe-separated format. Every row needs the same number of columns for renderers to display it correctly, which is why shorter rows are automatically padded with empty cells here.
Tips
- This is a simple delimiter split, not a full CSV parser — a comma inside a quoted cell will be read as a column break, so switch to tab-separated for data with embedded commas.
- A pipe character typed inside your data is automatically escaped (\|) so it doesn't break the table structure.
- Turn off 'First row is the header' if your data has no header row — generic Column 1, Column 2 labels are used instead.