Markdown Table to CSV Converter
README files, Notion exports, pull-request templates, and technical docs often store tables as Markdown pipe syntax. Spreadsheets and importers want CSV. This free Markdown table to CSV converter parses GitHub-flavored pipe tables in your browser and downloads clean CSV.
Paste a table that includes a header row and a separator row (`| --- | --- |`), or upload a .md file containing one. Alignment colons in separators are ignored; escaped pipes inside cells are preserved.
Key features
- Understands optional outer pipes and alignment markers (`:---:`).
- Skips separator rows automatically.
- Client-side only — paste never leaves the browser for conversion.
About the Markdown table to CSV format
A Markdown pipe table looks like `| Name | City |` on the header line, a separator of dashes, then data rows with the same column count. Leading and trailing pipes are optional but common.
Conversion skips separator rows, splits on unescaped `|`, trims cells, and uses the first data-bearing row as CSV headers.
How it works
Lines containing `|` are collected. Separator-only lines are dropped. Remaining lines are split into cells and assembled into a matrix via the shared CSV grid helpers.
Common use cases
- Moving a GitHub README comparison table into Excel for charting.
- Extracting a docs table from a Markdown export into a CRM import.
- Cleaning PR checklist tables into CSV for project tracking.
- Round-tripping with CSV to Markdown on this site.
How to use this tool
- Paste a Markdown pipe table (or upload .md).
- Convert and verify headers and row counts in the preview.
- Download CSV or open it in the CSV editor.
Example
Input Markdown
| name | city |
| --- | --- |
| Ada | London |
| Grace | Arlington |Output CSV
name,city
Ada,London
Grace,ArlingtonTips for best results
- Include the `---` separator row so parsers (and humans) recognize the table.
- Escape literal pipes in cells as `\|`.
- Paste only the table block if the file has lots of prose around it.
Common errors and how to fix them
- No Markdown table found.
- Ensure at least one line contains `|` and that you pasted a pipe table, not an HTML `<table>`.
Frequently asked questions
Does this support CSV to Markdown too?
Yes — use the CSV to Markdown converter on this site for the reverse direction.
For more background on data formats and conversion workflows, read our format guides.