How to convert a CSV file to a Markdown table

CSV (comma-separated values) is the format almost every app can export: banking portals, CRMs, analytics tools, spreadsheets. It's easy for software to read, but it isn't pleasant to read yourself, and pasting it into a README or a chat gives you a wall of commas.

A Markdown table fixes that. It looks like this:

| Month | Orders | Revenue |
|-------|-------:|--------:|
| Jan   |    112 | ₹48,300 |
| Feb   |    131 | ₹55,900 |

GitHub, GitLab, Notion, Obsidian and most documentation sites show it as a proper table, and AI assistants read it reliably.

Convert in three steps

1. Open the converter and drop the .csv file on it.
2. Docuflat reads the file and treats the first row as the table header.
3. Copy the Markdown table, or download it as a .md file.

The file is processed in your browser, so customer lists and financial exports aren't uploaded anywhere.

Things that trip up CSV conversions

Commas inside values. A value like Mumbai, Maharashtra is normally wrapped in quotes in the CSV. A proper converter respects the quotes and keeps it in one cell. If your columns look shifted, check whether the export quoted those values.

Pipes inside values. The | character separates columns in Markdown, so Docuflat replaces any | inside a cell with / to stop it creating an extra column.

Semicolon files. Spreadsheet software set to some European regional formats exports with ; instead of ,. If everything lands in one column, open the file in a spreadsheet and save it again as a comma-separated CSV, or convert the original .xlsx instead.

Encoding. If you see characters like é instead of é, or boxes instead of Hindi or Tamil text, the file was saved in an older encoding. Re-export it as "CSV UTF-8" from Excel or Google Sheets.

Numbers and dates. CSV stores exactly what the export wrote. If Excel showed 1.2E+05 or dates in an unexpected format, fix the format in the spreadsheet and export again.

Very large CSV files

A Markdown table with thousands of rows is hard to read and, in an AI chat, uses a lot of tokens. Before converting, consider:

• Filtering to the rows you actually need.
• Removing columns that don't matter for the question you're asking.
• Summarising first with a pivot table, and converting the summary instead.

For AI work in particular, a focused 50-row table usually gets a better answer than a 5,000-row dump. Our guide on using fewer tokens with documents explains why.

Excel files with several sheets

If your data is in an .xlsx workbook, you don't need to export CSV first. Drop the workbook on the converter and each sheet becomes its own table. See Excel to Markdown tables.

Summary

Drop the CSV on the converter and copy the table. If columns look wrong, check quoting, separators and encoding; if the file is huge, trim it before converting.