Home › CSV tools › CSV to Markdown table
Runs in your browserConvert CSV to a Markdown table
Pasting a table into a README, a pull request or documentation means writing Markdown pipe syntax by hand, which is tedious and easy to break. This converts a CSV into a valid table, escapes any pipe characters in your data, and can pad the columns so the raw Markdown is readable as plain text too.
How to use it
- Choose your CSV file. The first row becomes the table header.
- Pick an alignment — or let numeric columns right-align themselves.
- Click Convert and download the .md file.
Questions
Is my file uploaded anywhere?
No. This page contains the whole tool — the JavaScript that does the work runs inside your browser tab, on your own machine. There is no server to upload to. You can confirm it yourself: open your browser's developer tools, switch to the Network tab, and run the tool. You will not see your file go anywhere. You can also disconnect from the internet after the page loads and it will still work.
What happens to pipe characters in my data?
They're escaped as \| so they render as a pipe rather than ending the cell. Line breaks inside a cell become <br>, since a Markdown table row can't span multiple lines.
Should I pad the columns?
It's cosmetic — padded and unpadded render identically. Padding makes the raw Markdown readable in a plain text editor and diff cleanly by row, at the cost of a larger file and noisier diffs when a column's width changes.
Does this work with GitHub?
Yes. The output is standard GitHub Flavored Markdown table syntax, which also works in GitLab, Obsidian, Notion and most static site generators.