CSV/TSV to Markdown Table — GFM Pipe Tables

Q: Does round-tripping preserve newlines inside cells?

Not fully. CSV → Markdown replaces embedded newlines with ``. Markdown → CSV keeps `` as literal text and does not turn it back into a newline.

Convert spreadsheet CSV or TSV exports to GitHub-flavored Markdown pipe tables. Reverse mode copies a GFM table back to CSV or TSV. You paste or upload only, and it is not a visual spreadsheet editor.

Mode

First row is header

Alignment

Input delimiter

Share this tool:

Input

Output

Loading…

CSV/TSV to Markdown table

Converts CSV or TSV to GitHub-flavored Markdown pipe tables, and back. Paste text or open a file. This is not a visual grid editor.

Developer notes

GFM pipe tables only, with no grid tables or merged cells. Newlines inside cells become a literal `<br>` when you export to Markdown. The reverse conversion does not turn `<br>` back into newlines. The automatic numeric alignment reads period decimals only. Comma decimals such as 3,14 stay left-aligned. The cosmetic column padding in the Markdown output does not change the rendered table.

Options

Direction: Switches between CSV/TSV → Markdown and Markdown → CSV/TSV. The input and output are cleared when you change direction.
Header row: When on, the first CSV row becomes the column headers. When off, the headers “Column 1”, “Column 2”, … are generated and every row is data.
Column alignment: Alignment of the Markdown separator row: left, center, right or auto. Auto right-aligns the columns where most non-empty cells are numbers with a period decimal.
Input delimiter: For CSV → Markdown: detects comma, semicolon or tab from the first line, or forces one of them.
Output delimiter: For Markdown → CSV: the comma, semicolon or tab placed between the output fields.

Use cases

Paste a spreadsheet CSV export into a README table. Copy a GitHub table back to CSV for Excel or Sheets. Pair it with the Markdown TOC generator of the same hub. Not meant for building tables cell by cell. Export from a spreadsheet instead.

Examples

CSV to a Markdown table

Before

name,role,years Ada Lovelace,Mathematician,36 Grace Hopper,Admiral,43

After

| name | role | years | | :--- | :--- | ---: | | Ada Lovelace | Mathematician | 36 | | Grace Hopper | Admiral | 43 |

documentation.textTools.csvToMarkdownTable.examples.two.title

Before

documentation.textTools.csvToMarkdownTable.examples.two.before

After

documentation.textTools.csvToMarkdownTable.examples.two.after

Related tools

Part of the text tools hub. See also sort-dedupe-lines and markdown-toc-generator.

CSV/TSV to Markdown table FAQ

Privacy and limits

Is my data uploaded?

No. Conversion runs entirely in your browser. Opening a file reads it locally, and nothing is sent to FastMinify.

What is the size limit?

64 KiB of UTF-8 text per paste or file, like the other Text & Markdown tools.

Does round-tripping preserve newlines inside cells?

Not fully. CSV → Markdown replaces embedded newlines with `<br>`. Markdown → CSV keeps `<br>` as literal text and does not turn it back into a newline.

How does auto-numeric alignment work?

In auto mode, a column is right-aligned when more than half of its non-empty data cells are numbers. Only period decimals count, such as 42 or 3.14, so comma decimals such as 3,14 are not treated as numeric.

Count words, build Markdown TOCs, and clean line lists — all in your browser.