Delimiter.live
Data Conversion Tools Runs in your browser Free · no account

CSV to Markdown Table

The CSV to Markdown converter turns delimited data into a pipe table for a README, a pull request or a wiki. Columns are padded so the source stays readable, pipes inside cells are escaped, and line breaks become the one piece of HTML a Markdown table row accepts.

Options
CSV 0 characters
Markdown

Your result will appear here.

Not sure where to start? Use Load example.

Results update automatically and are calculated on your device. Nothing you type is sent to a server.

Runs in your browser. Processing happens entirely in your browser. Nothing you enter is sent to Delimiter.live.

How to use the CSV to Markdown Table

  1. Paste or upload the CSV.
  2. Confirm whether the first row is a header — without one, columns are numbered.
  3. Pick an alignment if you want the table aligned in rendered output.
  4. Copy the Markdown into your README, issue or wiki page.

Example

Input
name,role
Ada,Engineer
Output
| name | role     |
| :--- | :------- |
| Ada  | Engineer |

Common use cases

  • Putting a small dataset into a README or a pull request description.
  • Turning a spreadsheet of results into a table for documentation.
  • Converting a query export into something readable in a GitHub issue.
  • Building a comparison table without writing the pipes by hand.

Limitations and things to watch for

  • Markdown tables cannot contain block content. A cell with a line break gets a <br>, which most renderers accept, but lists and paragraphs inside a cell are not possible.
  • Column padding makes the source readable and has no effect on the rendered table. Renderers ignore the whitespace entirely.
  • A pipe inside a cell is escaped as \|. Some older Markdown renderers still mishandle it, which is a limitation of the format rather than the conversion.

Frequently asked questions

What happens to a pipe inside a cell?
It is escaped as \| so it does not end the column. That is the standard approach and works in GitHub, GitLab and most renderers, though a few older ones still get it wrong.
Why is the output padded with spaces?
So the Markdown source lines up and stays readable in a diff. Renderers ignore the padding, so the rendered table is identical either way.
Can a cell contain multiple lines?
Not as real line breaks — the format has no way to express them. A line break inside a quoted CSV field becomes a <br>, which most renderers honour inside a table cell.
Does it handle quoted fields with commas?
Yes. The file is read with the same RFC 4180 parser as the other CSV tools, so "Hopper, Grace" stays a single cell.

Share this tool