CSV to Markdown Table
Drop your CSV below to get a Markdown table, ready to paste into a README, a pull request or documentation. The conversion happens inside this browser tab, so the file is never uploaded to a server.
How to convert CSV to Markdown
- Choose your CSV file, or drag it onto the box below.
- Download the .md file, or copy the table from the preview.
- Paste it wherever Markdown is rendered.
Built for the diff, not just the render
Column widths are computed from the longest value in each column so the raw text aligns. A table someone can read in the source file is a table someone will actually maintain.
Header row is required
Markdown pipe tables have no headerless form — the divider line beneath the header is what makes it a table at all. If your CSV has no header row, untick the option and generic column names are used so the output still renders.
Questions
What happens to pipe characters in my data?
They are escaped as \|, because an unescaped pipe would be read as a column separator and break the row. This is the single most common way hand-made Markdown tables go wrong.
What about line breaks inside a cell?
Markdown tables cannot contain real line breaks, so they are converted to <br> tags, which render as line breaks in GitHub and most other Markdown processors.
Why are the columns padded with spaces?
So the raw Markdown lines up as a readable table in a text editor and in diffs. Renderers ignore the padding entirely, so it costs nothing visually and makes review far easier.
Will this work outside GitHub?
Yes. Pipe tables are supported by GitHub, GitLab, Obsidian, Notion imports and most static site generators. They are not part of the original Markdown spec, but support is close to universal.
Is my file uploaded anywhere?
No. The table is generated in JavaScript inside your own browser tab. Nothing is sent to a server, stored or logged.
Background
For why CSV files lose leading zeros, arrive as one long column, or show strange characters, see what a CSV file is. This page is one of the free CSV converter tools — all of them run in your browser and none of them upload your file.