CSV to Markdown Table Converter
CV-09Paste CSV and get a GitHub-style Markdown table for a README, issue or doc. Pipes inside cells are escaped, and you can pick the column alignment.
Runs in your browser. Nothing is uploaded.
CSV
Markdown
How to use it
- Paste your CSV into the input box, or open a .csv file (up to 5 MB) or drop it on the box.
- Leave Delimiter on Auto, or choose one. Untick First row is header if the CSV has no header.
- Choose a column alignment, and tick or untick Align columns in the text.
- Copy the Markdown or download it as a .md file.
What the table looks like
The output is a GFM pipe table: a header row, a separator row of dashes, then one row per CSV line. Alignment adds colons to the separator row, as in :--- for left, :-: for center and ---: for right. Align columns in the text pads each cell with spaces so the pipes line up when you read the source. That padding is cosmetic and does not change how the table renders.
Pipes, line breaks and other characters
A pipe inside a cell would split the column, so it is written as \|. A line break inside a cell is written as <br>, because a table row must stay on one line. Other Markdown characters, such as * or _ or square brackets, are not escaped, so text like *note* will be shown in italics when the table is rendered. Escape those yourself if you want them literal.
Header rows and short rows
Markdown tables need a header row. With First row is header on, your first CSV row is it. With it off, the headings are column_1, column_2 and so on, and every CSV row becomes a body row. A row with fewer cells than the widest row is padded with empty cells. Padding counts characters, so emoji and CJK text may look misaligned in a monospaced editor, but the table still renders correctly.
Error messages and what to do
| Message | What it means | Fix |
|---|---|---|
A quoted field is never closed (missing closing ") | A field starts with a double quote, but the text ends before the closing quote, so the parser cannot tell where the field stops. | Add the missing closing quote, or double any quote that belongs inside the text, as in "". |
No rows found in the CSV. | The input has no rows after blank lines are removed. | Paste the CSV data. |
Questions people ask
How do I convert CSV to a Markdown table?
Paste the CSV into the input box. The first row becomes the header, followed by the separator row and one row per CSV line. Copy the result into your README, issue or doc. It runs in your browser and nothing is uploaded.
How do I align columns in a Markdown table?
Choose Left, Center or Right under Column alignment. The separator row gets colons, such as :--- for left and ---: for right, which GitHub and most Markdown renderers read. The default leaves the separator as plain dashes.
What happens if a cell contains a pipe character?
The pipe is written as \| so it stays inside the cell instead of starting a new column. GitHub-style Markdown reads \| as a literal pipe inside a table row.
Can a cell contain a line break?
A Markdown table row has to stay on one line, so a line break in a cell is written as <br>. GitHub renders that as a line break in the cell. Some other renderers show the tag as text, so check where you plan to post it.
Does it work without a header row?
Yes. Untick First row is header and the headings are column_1, column_2 and so on, with every CSV row kept as a body row. A Markdown table cannot exist without a header row, so the generated one is added.
Does the CSV delimiter have to be a comma?
No. Delimiter is on Auto by default and picks comma, tab, semicolon or pipe from the first line. You can also choose one yourself, which is safer when the header line contains quoted commas.
About this tool
Output is a GitHub-style (GFM) pipe table, which needs a header row. If you turn off First row is header, the headings are column_1, column_2 and so on, and every CSV row stays a body row. A | in a cell is written as \| so it does not split the column, and a line break in a cell becomes <br>. Other Markdown characters in your text, such as * or _ or [ ], are not escaped, so they may format when rendered. Aligning the columns in the text pads with spaces (counted in characters, so wide characters such as emoji or CJK may look off in a monospaced view) and has no effect on how the table renders. Short rows are padded with empty cells. Cell text is not trimmed, but Markdown viewers ignore the spaces around it.