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.
Your file stays on this computer. There’s no upload button here, because there’s nowhere to send it. This tool runs inside the page you opened — like a calculator on a web page, it keeps working once it has loaded. How this works, and how to check it →
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. The whole tool is inside this page, so the work happens on your computer. There is no server to send it to. If you'd rather check than take our word for it: use the tool once, on a sample file, with the settings you want. Then turn off your wi-fi and do exactly the same thing again in that tab, without reloading. It still works, because everything it needs is already here.
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 look identical once rendered. Pad it if someone will read the raw Markdown in a text editor. Leave it off for a smaller file.
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.