CSV to Markdown table converter
About CSV ⇄ Markdown Table
The CSV to Markdown table converter works in both directions using GitHub Flavored Markdown (GFM) tables. Use it to put data in READMEs, pull requests and issues.
How it works
Valid GFM structure
Each table has one header row, a matching delimiter row of hyphens and any number of body rows. Rows start and end with a pipe for readability.
Escaped pipes in cells
A pipe inside a cell is escaped with a backslash, as GFM requires. Line breaks inside a CSV cell become <br>, so each record stays on one line.
Lenient body rows
When reading Markdown, short rows get empty cells and extra cells are dropped, as in GFM. The header and delimiter rows must have the same width.
Frequently asked questions
Are alignment markers supported?
Yes. Delimiter cells with leading or trailing colons are accepted when converting Markdown back to CSV.
What happens to a pipe inside a cell?
CSV to Markdown escapes it as \|. Markdown to CSV turns it back into a plain pipe.
Does the output work on GitHub?
Yes. The tables follow the GFM table rules.
Sources & last verified
We checked this tool's behavior and the claims on this page against the specifications below on . The tool runs in your browser, so the output you see is exactly what the engine produced.
Found a wrong result or an outdated claim? Report an error and we will check it again.
CSV ⇄ TSV
CSV to vCard
XLSX ⇄ CSV / JSON
cURL to Code
Data URI Encoder / Decoder
.env ⇄ JSON / YAML