CSV to Markdown Table

Turn CSV into a GitHub-style Markdown table, with pipes and a dashed header row, ready to paste into a README or issue. Runs locally.

Document Tools● Free No upload Instant

Loading CSV to Markdown Table…

Your browser is preparing the tool. It runs 100% locally.

Quick answer

Paste CSV and get a Markdown table: the first row becomes the header, a row of hyphens forms the separator, and every following row becomes a table row, all delimited by pipes. This is GitHub-Flavored Markdown table syntax, a GitHub extension to core Markdown, so it renders on GitHub, GitLab and most Markdown sites.

What the CSV to Markdown Table does

Paste comma-separated data and the tool emits a Markdown table you can copy or download as table.md. It opens on a small example and updates as you type.

Use it to drop tabular data into a README, an issue, a pull request or a doc, where a pipe table renders as a formatted table instead of a wall of commas.

How it works

It parses the CSV with the RFC 4180 rules, so quoted fields with commas inside are handled. It takes the first row as the header, writes a separator row of hyphens beneath it, and lays out each remaining row between pipe characters.

The result is GitHub-Flavored Markdown (GFM) table syntax: pipes separating the columns and hyphens marking the header. Most Markdown renderers understand it, even though core Markdown and CommonMark define no table syntax at all.

Data source and conversion logic

No external data. The CSV is read per RFC 4180 and rewritten as a GitHub-Flavored Markdown (GFM) table, with pipes and a hyphen separator row, all in your browser.

  1. Step 1. Parse the CSV per RFC 4180, handling quoted fields.
  2. Step 2. Take the first row as the table header.
  3. Step 3. Write a separator row of hyphens, one cell per column.
  4. Step 4. Write each remaining row as a pipe-delimited table row.
  5. Step 5. Copy the Markdown or download table.md.

Privacy

The CSV you paste is converted in your browser; nothing is uploaded.

The tool stores nothing, and the table is gone when you close the tab.

Technical details

InputCSV (header row)
OutputGFM Markdown table
SyntaxPipes plus a hyphen separator row
CSV parsingRFC 4180 (quoted fields handled)
Renders onGitHub, GitLab, most Markdown sites
Downloadtable.md
Where it runsIn your browser, live

Standards & references

  • GitHub Flavored Markdown (GFM) tables: the pipe-and-hyphen table syntax this produces. Tables are a GFM extension popularised by GitHub, not part of core Markdown.
  • RFC 4180: the CSV reading rules, with a comma delimiter and double quotes around fields that contain commas.
  • CommonMark: the core Markdown spec, which defines no table syntax. That is why pipe tables come from GFM rather than CommonMark.

Accuracy and limits

It produces GFM table syntax, which isn't part of core Markdown or CommonMark. So it renders on GitHub, GitLab and most modern Markdown engines, but a strict CommonMark-only renderer will show the raw pipes instead of a table.

A cell that itself contains a pipe character will break the table, because the pipe is the column delimiter. Remove or escape pipes in your data first.

It doesn't add column alignment (GFM's optional colons in the separator row), so every column uses the renderer's default alignment.

The first row is always treated as the header; there's no header-less table option.

Where people use it

Tables in a README

Drop a data export into a README or wiki as a proper formatted table.

Issues and pull requests

Add a quick table to a GitHub issue or PR description.

Docs from a spreadsheet

Turn a spreadsheet selection into Markdown for your documentation.

Markdown notes

Make tables for a notes app that speaks Markdown.

When it fits, and when it doesn't

Good for

  • CSV into README or issue tables
  • GitHub and GitLab documentation
  • Markdown notes apps
  • A quick formatted table from data

Not the best choice for

  • Strict CommonMark-only targets
  • Data that contains pipe characters
  • Tables that need column alignment

Target renders only strict CommonMark? Keep the data as HTML or CSV. Need column alignment or piped data handled? Add the alignment colons and escape the pipes by hand after converting.

Frequently asked questions

What table syntax does it produce?
GitHub-Flavored Markdown tables: columns separated by pipe characters, with a row of hyphens under the header. It's the format you see in README files and issues.
Will the table render everywhere?
On GitHub, GitLab and most modern Markdown renderers, yes. A strict CommonMark-only renderer defines no tables, so it would show the raw pipe characters instead.
What if a cell contains a pipe character?
It will break the table, because the pipe is the column separator. Remove or escape pipes in your data before converting.
Does it set column alignment?
No. GFM lets you add colons in the separator row to align columns; this tool leaves them out, so columns use the default alignment. Add the colons by hand if you need them.
Is the first row always the header?
Yes. The first CSV row becomes the table header and gets the hyphen separator beneath it; there's no header-less option.
Does it handle quoted CSV fields?
Yes. The CSV is parsed per RFC 4180, so a comma inside a quoted field stays part of that cell rather than splitting it.
Can I download the table?
Yes. Copy it from the output, or use Download to save table.md.
Is my data uploaded?
No. The conversion runs in your browser and nothing you paste is transmitted or stored.
Why does my table show raw pipes on some site?
That renderer doesn't support GFM tables. Pipe tables are a GitHub extension, so a strict CommonMark renderer won't format them.
Are tables part of standard Markdown?
No. Core Markdown and CommonMark define no table syntax; tables come from GitHub-Flavored Markdown, which most platforms have adopted.
Does it accept semicolon or tab files?
No, comma-separated only. Convert a semicolon or tab file to comma-CSV first.
Can I paste the result straight into GitHub?
Yes, that's the main use. Paste it into a README, issue or pull request and GitHub renders it as a table.

References

Emits GitHub-Flavored Markdown table syntax (pipes and a hyphen header row). Most renderers support this GitHub extension, though strict CommonMark defines no tables, and a pipe inside a cell will break the table.

Popular

CSV to JSON Converter

CSV rows become a JSON array, keyed by the header row.

DocumentOpen
Popular

JSON to CSV Converter

Flatten a JSON array of objects into CSV columns.

DocumentOpen
Trending

Markdown to HTML

Turn everyday Markdown into clean HTML in your browser.

DocumentOpen

CSV to Excel Converter

Pasted CSV becomes a real .xlsx, with leading zeros kept.

DocumentOpen

Excel to CSV Converter

Pull the first sheet of a workbook out as plain CSV.

DocumentOpen

Excel to JSON Converter

Each spreadsheet row becomes a JSON object keyed by the header.

DocumentOpen

Back to the CSV to Markdown Table

The file never leaves your computer, and you don't need an account.