Convert CSV to Markdown

Convert CSV to Markdown in your browser: load your CSV, choose Markdown as the target, and download the result. This conversion preserves every value in your data, and nothing is uploaded to a server.

Convert CSV to MarkdownRuns in your browser. Nothing uploaded.

When you need this

Getting a spreadsheet into a README, a pull request, an issue or a wiki page as a table someone will actually read. The most reliably lossless conversion in the set, because both formats describe the same thing: rows and columns of text.

How to convert CSV to Markdown

Load your CSV: Drag the .csv file in, or paste the rows. An export from Excel, Numbers or a database client works unchanged, including a quoted header row. Nothing leaves your browser at this or any later step.
Choose the target format: Press Ctrl+Shift+K (Cmd+Shift+K on a Mac) to open the conversion panel, then pick Markdown as the target. The source and the result sit side by side.
Read the loss report: The panel shows whether the conversion is lossless for your particular data, and lists every value it had to transform. Adjust indentation, key sorting and null handling if you need to.
Take the Markdown: Download the .md file, copy it, or open it as a new tab to keep working on it in the Markdown views.

What survives the conversion

CSV to Markdown is lossless for your data: convert back and every value returns. Formatting does not survive — comments and whitespace are lost by every conversion in every direction, in every tool.

Pipe characters in cell values are escaped, so a cell containing a|b does not silently add a column and shift every heading after it.
The header row becomes the table header and the separator row is generated, which is what every Markdown renderer requires.
No types are inferred and nothing is reformatted — the text in a cell is the text in the table. That is why this conversion loses nothing.

A worked example

A pipe in a value, escaped:

command,purpose
"ls | wc",count files

CSV in

| command | purpose |
| --- | --- |
| ls \| wc | count files |

Markdown out

Privacy

The conversion runs in your browser — in a Web Worker for anything above a quarter of a megabyte, so the page stays responsive. Your data is not uploaded, not logged and not stored. There is no account, and the whole thing works offline.

Convert CSV to Markdown

Questions

Is CSV to Markdown really lossless?

For the values, yes — every cell arrives as the text it was, and this is one of only four conversions in the set that preserves everything. What Markdown does not carry is anything a spreadsheet added on top: formulas, number formats, merged cells and colours were never in the CSV either.

Is converting CSV to Markdown lossless?

For the data, yes — every value survives a round trip. Formatting does not: comments, whitespace and in some cases key order are lost by any conversion between these formats. A clean table conversion. Pipes in cell values are escaped.

Is my CSV uploaded to a server?

No. The file is read and converted by your browser. Nothing about its contents is sent anywhere, which you can verify in your browser’s network panel or by using the tool with the network disconnected.