CSV to Markdown Table: Format Data for GitHub and Docs

Markdown tables are the cleanest way to show data in a README, GitHub issue or documentation site — but writing all those pipes by hand is painful. If your data is already in a spreadsheet or CSV, convert it. Here's how to make a Markdown table from CSV.

Convert CSV to a Markdown table

Paste your CSV into the CSV to Markdown Table tool and get a GitHub-flavored Markdown table — the first row becomes the header and the separator row is added for you. Copy it straight into your .md file.

Going the other way

Need to pull data out of an existing Markdown table? The Markdown Table to CSV tool reverses it, ignoring the separator row and restoring escaped pipes.

Prefer HTML tables?

Some platforms render HTML better than Markdown. Use the CSV to HTML Table tool for a clean <table>, or extract data from a web page with HTML Table to CSV.

Tips for clean tables

Keep cell text short (Markdown tables don't wrap well), escape any literal pipe characters, and remember that alignment colons in the separator row control column alignment. For big datasets, a scrollable HTML table often reads better than Markdown.

Starting from Excel?

Convert your workbook to CSV first with Excel to CSV, then run it through the Markdown converter.