CSV

CSV to Markdown Table Converter

Converts delimited rows into a GitHub-flavoured Markdown table.

Loading the tool…

Processing happens locally in your browser. What you paste or load is processed by this page and is not uploaded to a server. Nothing is stored unless you use a control that says it stores something, and you can clear anything this site has kept from the privacy page.

How to use this tool

  1. Paste the CSV.
  2. Choose a column alignment if you want one.
  3. Convert, then copy the table into your document.

What csv to markdown table does

Markdown tables are the standard way to put tabular data into a README, a pull request description or a documentation page, and typing the pipes by hand is tedious for anything past three rows. This converter takes the delimited file you already have and writes the pipe-and-dash form, including the alignment row that tells the renderer which columns are which.

Pipe characters inside a value would otherwise break the table, so they are escaped, and any line break inside a quoted field is replaced with a space because Markdown tables cannot contain one. The result renders identically on GitHub, GitLab and most static site generators, and stays readable as plain text if it is never rendered at all.

Frequently asked questions

It is escaped with a backslash so it renders as a pipe instead of splitting the cell.

Markdown tables cannot hold one, so any line break inside a quoted field becomes a space. If you need multi-line cells, use the HTML table converter instead.

Yes. The output is GitHub-flavoured Markdown table syntax, which also renders on GitLab and in most static site generators.