CSV to Markdown Table Converter - Tables for READMEs and Docs
READMEs, docs and issue comments all render Markdown tables. Paste CSV and get a table that renders correctly the first time - alignment and escaping handled.
How to use the CSV to Markdown Table Converter
- Paste your CSV - the first row becomes the table header.
- Click Convert to Markdown.
- Copy the table into your README, doc or comment.
- Numeric columns are right-aligned automatically.
How it works
Alignment is detected per column: if every non-empty value in a column looks like a number (thousands separators and a trailing % are allowed), the separator row uses ---: to right-align it, the way numbers should line up; other columns use the default left alignment. Pipe characters inside a value are escaped as \| so a value can never split a cell, and line breaks inside quoted fields become <br>, which Markdown renderers keep inside the table row.
Frequently Asked Questions
Is this converter free?
Yes - completely free, no sign-up.
Where can I use the output?
Anywhere Markdown tables render: GitHub and GitLab READMEs, docs sites, Notion-style tools and issue trackers.
How is alignment decided?
A column whose values are all numeric is right-aligned; all other columns are left-aligned.
What if a value contains a pipe character?
It is escaped as \| so it stays inside its cell instead of breaking the table.
Is my data uploaded?
No. Conversion runs entirely in your browser.
Related Developer Tools
CSV to JSON Converter
Convert CSV to a JSON array of objects - a real parser that handles quoted commas and escaped quotes.
JSON to CSV Converter
Turn a JSON array of objects into a clean CSV file - union of all keys, proper quoting, one click.
CSV Viewer & Editor
Load CSV into an editable table grid - edit cells, sort columns, add rows and download the result.