CSV ⇄ Markdown Table
About CSV ⇄ Markdown Table
CSV ⇄ Markdown Table converts tabular data to and from the GitHub Flavored Markdown table extension, making datasets easy to place in READMEs, pull requests and issue descriptions.
How it works
Valid GFM structure
Generated tables contain one header row, a matching hyphen delimiter row and zero or more body rows, with leading and trailing pipes for readability.
Escaped cell pipes
Literal pipe characters inside cells are backslash-escaped as required by GFM. Embedded CSV line breaks become <br> so the Markdown table stays on one physical row per record.
Tolerant body rows
When reading Markdown, short rows receive empty cells and extra cells are ignored, matching GFM table behavior. Header and delimiter widths must match.
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 \|, and Markdown-to-CSV restores the literal pipe.
Is this GitHub-compatible?
Yes. The generated structure follows the GFM table extension rules.
Sources & last verified
The behaviour of this tool and the claims on this page were checked against the specifications below on . Everything 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 it will be re-verified.