CSV to Markdown Table Converter
Paste CSV or choose a file and get a Markdown table for a README, pull request or doc. It runs in your browser and nothing is sent anywhere.
Paste CSV or choose a file to generate a Markdown table.
How to convert CSV to a Markdown table
- Paste your CSV into the box, or choose a local file of up to 1 MB saved as UTF-8.
- Choose the header row. Rows above it are left out, which helps when an export starts with a title line. If your data has no header, choose no header row and the table gets an empty one, because GitHub Flavored Markdown requires a header.
- Set the alignment of any column you want to change.
- Check the preview, then copy the Markdown.
Example, including a multiline value
The quoted value in the first data row holds a comma and a line break, and the next row holds a pipe and an empty cell.
Name,Notes,Price "Widget, large","First line Second line",12.50 Gadget|Pro,,8
| Name | Notes | Price | | --- | --- | --- | | Widget, large | First line<br>Second line | 12.50 | | Gadget\|Pro | | 8 |
The line break becomes <br> because a Markdown table cell has to stay on one line. The pipe becomes \| so it stays inside its cell, and the comma needs no escaping once it is out of the CSV.
Frequently asked questions
How are multiline CSV values shown in Markdown?
A Markdown table cell has to stay on one line, so each line break inside a quoted CSV value becomes <br>. Most Markdown renderers, including GitHub, display that as a line break inside the cell.
What happens to pipes, backslashes and backticks in my data?
Outside code spans, a backslash is added before each backslash, pipe and unmatched backtick, so a pipe becomes \| and does not start a new column. Inside a code span only pipes are escaped, because backslashes are already literal there. A code span containing \| or a line break has no exact form in a table cell, so it becomes literal text with its backticks visible.
Are HTML and Markdown formatting in my values escaped?
No. The output protects cell boundaries, not inline formatting, so <img>, *x* and & stay active and a Markdown renderer may render them. The preview on this page always shows plain text. Check untrusted data before publishing the Markdown.
What if my rows have different numbers of cells?
The table is as wide as its widest row. Shorter rows get empty cells at the end, so every value stays in its original column.
Why was my CSV rejected?
A stray or unclosed quote makes it ambiguous where a value ends, so the converter shows the line and column instead of guessing. Wrap the value in double quotes and double any quotes inside it: "12"" wide".
Does it support tabs or semicolons?
No. It reads comma-separated values only, so a semicolon or tab-separated file becomes a single column.
Is my data uploaded?
No. Parsing and conversion run in your browser. Your CSV stays out of the URL and is not saved or sent anywhere, so it is gone when you close the page.