CSV to
Markdown table
Convert CSV data to properly formatted Markdown tables, ready for documentation.
Publishing this data to a markdown-based docs site?
md0 CMS connects to your GitHub repo, so the tables in your content stay editable in a visual editor instead of being retyped by hand.
CSV to markdown table format
CSV format
- Requires a header row.
- Columns are separated by commas.
- Quote fields that contain commas: "value, with comma".
- Supports .csv files and pasted text.
Output format
- Generates a GitHub Flavored Markdown table with | pipe separators and --- dividers.
- Compatible with GitHub, Notion, and any markdown renderer.
Tips
- The first row becomes column headers.
- Remove trailing commas.
- Use consistent quoting for special characters.
When to use this tool
GitHub README tables
Your project has a comparison sheet in Google Sheets listing supported environments, versions, or configuration options. You need that data in your README. Export it as CSV, paste it here, and drop the result straight into your markdown file.
Docs and wikis
Your team maintains a pricing sheet or feature matrix in Excel. Someone asks you to add it to the internal wiki or a Notion page. Exporting to CSV and converting here takes about 30 seconds versus writing pipe syntax by hand for a dozen columns.
Static site content
You run a static site with MDX or plain markdown content files. A product list, spec table, or changelog lives in a spreadsheet. Rather than re-entering the data in markdown syntax, export it, convert it, and paste the output into your .md file.
How it works
Parse
The tool reads your CSV input line by line, splitting on commas and respecting quoted fields that contain commas or newlines. It treats the first row as your header row.
Build
The tool wraps each row in pipe characters to produce valid GFM (GitHub Flavored Markdown) table syntax, then inserts a separator row with --- below the header automatically.
Output
The result renders correctly on GitHub, GitLab, Notion, Obsidian, and any editor or renderer that supports GFM tables. Nothing is sent to a server, and conversion runs in your browser.
Frequently asked questions
What if my CSV has commas inside cell values?
Wrap those values in double quotes in your CSV, for example "London, UK". Most spreadsheet apps do this automatically when you export to CSV. The parser handles quoted fields correctly and will not split them on the comma.
Does the output work on GitHub?
Yes. The output follows GitHub Flavored Markdown table syntax, which GitHub renders as a formatted table in README files, issues, pull requests, and wiki pages. It also works on GitLab, Bitbucket, and any markdown renderer that supports GFM.
How do I export a CSV from Google Sheets?
In Google Sheets, go to File, then Download, then select Comma Separated Values (.csv). Open the downloaded file in a text editor, copy the contents, and paste into the input field above. You can also drag the .csv file directly into the tool if file upload is supported.
Is my data sent to a server?
No. The conversion runs entirely in your browser using JavaScript. Your CSV data never leaves your machine, which makes this safe to use with internal or sensitive spreadsheet data.
Related tools
Markdown table generator
Build a markdown table from scratch with a visual grid editor, no CSV required.
Excel to markdown table
Convert Excel spreadsheet data directly to markdown table format.
HTML table to markdown
Paste an HTML table and convert it to markdown pipe syntax in one click.
Markdown table to CSV
Go the other direction: paste a markdown table and download it as a .csv file.