Convert CSV to a Markdown table

Why convert CSV to Markdown?

GitHub, GitLab, Notion, Obsidian and most wikis show Markdown tables. In a README, an issue or a pull request, a table is much easier to read than a block of comma-separated text, and it stays readable as plain text too.

How to convert CSV to a Markdown table

Drop a .csv file above and press Convert. The first CSV row becomes the table header and a separator row is added under it. Each other row becomes a table row. Quoted fields are read correctly, so a cell with a comma stays one column. Download the .md file and copy the table into your document.

Escaping and alignment

Pipe characters inside cells are escaped as \| so they don't split the table, and line breaks inside a cell become <br>. Short rows are padded with empty cells so every row has the same number of columns. Columns are left-aligned by default. Add a colon to the separator row by hand to center or right-align a column.

Compatibility

The output is GitHub Flavored Markdown. It renders anywhere GFM tables work, which includes most static site generators and documentation tools. Very wide tables scroll sideways on GitHub, so drop columns you don't need from the CSV first.

Before you start

Input: CSV. Output: Markdown. The settings appear before anything runs, so you can check them first. Your original file is never changed.

A valid file can still hold the wrong data. Before you import the result, check the row count, field names, text encoding, dates, IDs and a few unusual rows.

Keep the original until you have opened and checked the result. The work happens in this browser tab, so the size you can handle depends on your device's memory, your browser and the file itself.

Steps to convert CSV to a Markdown table

1. Drop a .csv file into the box above.
2. Press Convert to build the table in your browser.
3. Download the Markdown and copy the table into your doc.