Tools

CSV to Markdown table

Paste a CSV export and get a Markdown table ready for a README or an issue.

Runs in your browserData formats13.6K
Free

Input

0 BFree up to 50.0 KB

Result

The result will appear here.

Your runs

Only runs that cost points are saved.

Sign in to keep a history of your runs.

Markdown tables are painful to write by hand and trivial to generate. Paste anything comma-separated — a spreadsheet export, a query result, a pasted range — and get a table you can drop straight into a README, a pull request description or an issue comment. Pipe characters inside cells are escaped, so a value like a|b does not silently split into two columns.

How it works

  • The first row is read as the column headers.
  • Pipes are escaped and newlines inside a cell are collapsed to spaces, because a Markdown table row must stay on one line.
  • Column alignment applies to every column at once, which is what the separator row can express.

Where your data goes

Nowhere. This tool runs entirely in your browser: the text you paste is processed by the page and is never transmitted to a server or written to a log.

When a run costs points, a one-line summary is saved to your own history so you can find it again. The summary records the shape of the run — sizes, counts, the values you looked up — never the content you pasted.

What it costs

Free up to 50.0 KB per run without an account. Past that, a run costs 1 points and is saved to your history.

Points come from signing up, checking in daily, commenting and completing your profile.

See how points work

Common questions

My table renders as plain text on GitHub. Why?
GitHub needs a blank line before a table. If the table follows a paragraph directly, add an empty line between them.
Can different columns have different alignment?
The Markdown syntax supports it, but this tool applies one alignment to all columns. Editing the separator row afterwards takes a moment and is easy to get right by hand.
Do the columns need to line up in the output?
No. Markdown ignores the whitespace inside a table row entirely; renderers only need the pipes.

The open-source behind it

This tool runs on mholt/PapaParse, released under MIT. If you need the same behaviour inside your own program, that is the library to reach for.

mholt/PapaParse

Also known as

  • csv to markdown
  • markdown table generator
  • csv to markdown table
  • table to markdown