CSV to Markdown Table

Paste CSV — from a spreadsheet, database export or log — and get a GitHub-flavored Markdown table with padded, evenly aligned columns that stay readable even as raw text. Everything runs in your browser.

csv-to-markdown-table · runs locally

CSV to Markdown tables that stay readable as text

Most CSV-to-Markdown converters emit technically valid but visually ragged output — every row a different length, impossible to scan in a code review. This tool pads every column to the width of its longest cell, so the raw Markdown lines up like a fixed-width table even before it is rendered. That matters anywhere the source is read as text: pull request descriptions, README diffs, plain-text documentation.

The parser follows RFC 4180, so quoted fields containing commas, quotes and even newlines convert correctly. Pipes inside cells are escaped as \| and embedded newlines become <br>, the standard GFM workarounds. The delimiter is auto-detected (comma, semicolon, tab or pipe) with a manual override, and everything runs locally in your browser.

How to convert CSV to a Markdown table

  1. Paste your CSV into the input — the table appears immediately.
  2. Untick First row is a header if your data has none; generated Column N headers are used instead.
  3. Set per-column alignment (left, center, right) if you want it.
  4. Check the live preview, then copy the Markdown.

Alignment and the separator row

The second line of a GFM table controls alignment: colons on the left (:---), both sides (:---:) or the right (---:) of the dashes align the entire column. Right alignment is worth using for numeric columns. If you need real HTML instead — say for an email or a CMS that strips Markdown — the CSV to HTML Table converter produces the same table as clean, escaped markup.

Frequently asked questions

Is my CSV data uploaded anywhere?

No. Parsing and Markdown generation happen entirely in your browser with JavaScript — nothing is sent to a server. CSV exports often contain customer or production data, so this tool is deliberately built to work offline once the page loads.

Where does this Markdown table syntax work?

The pipe-table syntax is GitHub Flavored Markdown (GFM). It renders on GitHub, GitLab, Bitbucket, Obsidian, Notion imports and most static-site generators. Discord only partially supports it, and core CommonMark has no table syntax at all — check your renderer if the table shows up as plain text.

Can a Markdown table cell contain line breaks or lists?

Not natively — a Markdown table row must be a single physical line, and cells cannot hold lists or paragraphs. This tool converts newlines inside cells to <br> tags, which most GFM renderers accept as the standard workaround for multi-line content.

How does column alignment work in Markdown?

Alignment is set by colons in the separator row: :--- is left, :---: is center, and ---: is right. Pick an alignment per column above and the tool writes the correct separator — the alignment applies to the whole column when rendered.