CSV to Markdown Table screenshot

CSV to Markdown Table

Convert CSV data to a GitHub-flavoured Markdown table.

Privacy First
0 Runs
Updated 2026-11-07
Runs in your browser
No account needed
Your file is not uploaded
Works offline after load

Convert CSV data to a GitHub-flavoured Markdown table. Paste your content and get an instant result.

Paste comma-, tab-, semicolon- or pipe-separated data, or open a `.csv`, `.tsv` or `.txt` file, and this page returns a GitHub-flavoured Markdown table with a header row and a `---` divider.

The delimiter is chosen by counting candidates outside quoted regions, so a comma inside a quoted field cannot outvote a genuine tab separator. Quoted fields follow the usual doubled-quote escape and may contain newlines.

The download is a `.md` file named `table-` plus the date and time. The conversion runs in the tab; the file is read locally and never uploaded.

How rows and columns are shaped

The first record becomes the header row. Every later record becomes a body row, and a blank line is dropped rather than kept as an empty row.

Columns are padded to the widest record, so a ragged CSV gains empty cells rather than losing data. A record wider than the header simply extends the table.

Every cell is escaped for Markdown: a pipe becomes `\|` so it cannot split the row, and a newline inside a quoted field becomes `<br>` so the row stays one row. Every emitted row carries the header's column count.

  • Delimiters sniffed: comma, tab, semicolon, pipe
  • First record is the header
  • Pipes escaped as `\|`, newlines rendered as `<br>`

What the output does not preserve

Alignment markers are not produced: every column gets a plain `---`, so a numeric column is not right-aligned in the rendered table. Adding `:` markers needs a text editor.

Cell content is copied as text. A formula, a leading zero and a date are kept exactly as written, which is what you want for a table and not what a spreadsheet would do on import.

How to use the converter input

Paste the delimited data into the input workspace or open a `.csv`, `.tsv` or `.txt` file. The delimiter is detected by counting candidates outside quoted regions, and conversion starts as you type.

Copy the table or press Download to save the dated `table-` `.md` file. Quoted commas, doubled-quote escapes and newlines inside quoted fields survive; the file is read locally and never uploaded.

What to Expect

Best for

  • Turning a pasted spreadsheet selection into a table for a README
  • Converting a tab-separated export into Markdown
  • Getting a table into a pull request or a wiki page

Not ideal for

  • Choosing column alignment, which the output does not carry
  • Very wide tables, which render poorly in a Markdown viewer
  • A file with a delimiter outside the four that are sniffed

What this tool keeps

  • Quoted fields, including ones containing the delimiter and newlines
  • Commas and quotes in a cell quoted rather than split
  • A pipe in a cell escaped, so the row keeps its column count

What may need cleanup

  • Column alignment, which must be added to the divider row by hand
  • A header row that came from the data and needs renaming
  • A cell whose text already contains the literal characters `<br>`

Common errors

  • Pasting data whose first line is not a header and getting a table titled with the first record
  • Expecting a multi-line cell to stay on several lines, when the newline becomes `<br>`
  • Expecting the download to be a `.csv`, when the file is a Markdown document

Example use cases

  • A short pricing table for a project README
  • An exported issue list turned into a documentation table
  • A settings matrix pasted from a spreadsheet

Sample input

Three lines of comma-separated data: name, role and city, with one cell quoted because it contains a pipe.

Sample output

A Markdown table with three columns and a `---` divider, the pipe cell escaped as `\|`, downloaded as a timestamped `.md` file.

Who this is for

  • Developers writing README and wiki tables
  • Technical writers moving spreadsheet data into docs
  • Anyone who needs a table that renders on GitHub

Want the other direction? Use the Markdown Table to CSV.

Frequently asked questions

What kind of table does the converter produce?

A GitHub-flavoured Markdown table with a header row and a divider row, from comma-, tab-, semicolon- or pipe-separated data.

Does it preserve column alignment?

No. Alignment is not carried in the output and must be added to the divider row by hand.

How is a pipe inside a cell handled?

A pipe in a cell is escaped, so the row keeps its column count.

Developer program

Build custom tools for your store

Join the SDK program to create useful ecommerce utilities for your store.