CSV to Markdown Table
Convert a CSV file to a Markdown table instantly in your browser. Nothing is uploaded.
Built with PapaParse (MIT), self-hosted.
How to use this tool
- Paste CSV text.
- Click Convert.
- Copy or download the Markdown table.
Convert a CSV file to a Markdown table instantly in your browser. Nothing is uploaded.
How it works
This tool converts comma-separated values into a Markdown table you can paste directly into a README, wiki page, or documentation site. Paste or upload your CSV and the formatted table appears instantly.
Markdown tables use pipe characters (|) to separate columns and a dashed separator row after the header. Most Markdown renderers — including GitHub, GitLab, Notion, and Obsidian — display these as formatted HTML tables automatically.
The converter handles quoted fields so that a cell containing a pipe character or a comma does not break the table structure. Column widths in the output are padded for readability when viewing the raw Markdown.
Nothing is uploaded; the conversion runs entirely in your browser, making it safe to use with internal data or proprietary content.
Worked example
Add a dependency table to a README
- Export your package list as a CSV with columns Name, Version, License.
- Paste the CSV text into the converter.
- Copy the generated Markdown table.
- Open your README.md and paste the table under a Dependencies heading.
A properly formatted Markdown table that renders as a styled grid on GitHub.
Common mistakes to avoid
- Pasting a CSV that has extra blank lines at the top — the converter treats the first non-empty row as the header, so remove any title rows above the column names.
- Expecting the raw Markdown to look like a table — the formatted output only appears after a Markdown renderer processes it.
- Using the output in plain-text emails or Word documents where Markdown syntax is not interpreted.
Key terms
- Markdown table
- A Markdown syntax for tables using | as column separators and a --- row to mark the header, supported by most Markdown renderers.
- Pipe character
- The | symbol used as a column delimiter in Markdown tables; must be escaped if it appears inside a cell value.
Frequently asked questions
- Does it handle quoted commas?
- Yes — PapaParse handles RFC 4180 quoted fields correctly.