CSV to Markdown Table
Convert CSV data to a GitHub-flavoured Markdown table.
Convert CSV data to a GitHub-flavoured Markdown table. Paste your content and get an instant result.
Paste comma-, tab-, semicolon- or pipe-separated data, or open a `.csv`, `.tsv` or `.txt` file, and this page returns a GitHub-flavoured Markdown table with a header row and a `---` divider.
The delimiter is chosen by counting candidates outside quoted regions, so a comma inside a quoted field cannot outvote a genuine tab separator. Quoted fields follow the usual doubled-quote escape and may contain newlines.
The download is a `.md` file named `table-` plus the date and time. The conversion runs in the tab; the file is read locally and never uploaded.
How rows and columns are shaped
The first record becomes the header row. Every later record becomes a body row, and a blank line is dropped rather than kept as an empty row.
Columns are padded to the widest record, so a ragged CSV gains empty cells rather than losing data. A record wider than the header simply extends the table.
Every cell is escaped for Markdown: a pipe becomes `\|` so it cannot split the row, and a newline inside a quoted field becomes `<br>` so the row stays one row. Every emitted row carries the header's column count.
- Delimiters sniffed: comma, tab, semicolon, pipe
- First record is the header
- Pipes escaped as `\|`, newlines rendered as `<br>`
What the output does not preserve
Alignment markers are not produced: every column gets a plain `---`, so a numeric column is not right-aligned in the rendered table. Adding `:` markers needs a text editor.
Cell content is copied as text. A formula, a leading zero and a date are kept exactly as written, which is what you want for a table and not what a spreadsheet would do on import.
How to use the converter input
Paste the delimited data into the input workspace or open a `.csv`, `.tsv` or `.txt` file. The delimiter is detected by counting candidates outside quoted regions, and conversion starts as you type.
Copy the table or press Download to save the dated `table-` `.md` file. Quoted commas, doubled-quote escapes and newlines inside quoted fields survive; the file is read locally and never uploaded.
What to Expect
Best for
- Turning a pasted spreadsheet selection into a table for a README
- Converting a tab-separated export into Markdown
- Getting a table into a pull request or a wiki page
Not ideal for
- Choosing column alignment, which the output does not carry
- Very wide tables, which render poorly in a Markdown viewer
- A file with a delimiter outside the four that are sniffed
What this tool keeps
- Quoted fields, including ones containing the delimiter and newlines
- Commas and quotes in a cell quoted rather than split
- A pipe in a cell escaped, so the row keeps its column count
What may need cleanup
- Column alignment, which must be added to the divider row by hand
- A header row that came from the data and needs renaming
- A cell whose text already contains the literal characters `<br>`
Common errors
- Pasting data whose first line is not a header and getting a table titled with the first record
- Expecting a multi-line cell to stay on several lines, when the newline becomes `<br>`
- Expecting the download to be a `.csv`, when the file is a Markdown document
Example use cases
- A short pricing table for a project README
- An exported issue list turned into a documentation table
- A settings matrix pasted from a spreadsheet
Sample input
Three lines of comma-separated data: name, role and city, with one cell quoted because it contains a pipe.
Sample output
A Markdown table with three columns and a `---` divider, the pipe cell escaped as `\|`, downloaded as a timestamped `.md` file.
Who this is for
- Developers writing README and wiki tables
- Technical writers moving spreadsheet data into docs
- Anyone who needs a table that renders on GitHub
Want the other direction? Use the Markdown Table to CSV.
Frequently asked questions
What kind of table does the converter produce?
A GitHub-flavoured Markdown table with a header row and a divider row, from comma-, tab-, semicolon- or pipe-separated data.
Does it preserve column alignment?
No. Alignment is not carried in the output and must be added to the divider row by hand.
How is a pipe inside a cell handled?
A pipe in a cell is escaped, so the row keeps its column count.
Build custom tools for your store
Join the SDK program to create useful ecommerce utilities for your store.