Convert CSV to a Markdown table
Paste CSV and get a GitHub-flavored Markdown table back, ready for a README, a pull request, a wiki page or a prompt. Pipe characters inside your data are escaped so the table cannot silently break.
What the output looks like
The header row becomes the table header, and the output is GitHub-flavored Markdown, which renders on GitHub, GitLab, Notion, Obsidian and most static-site generators:
| name | role |
| --- | --- |
| Ada Lovelace | Engineer |
| Grace Hopper | Admiral |Pipes are escaped, newlines are collapsed
A literal | in a cell ends the column early, so the table renders with the wrong number of columns from that row down — and it does it silently, which is why this is the classic bug in hand-rolled converters. Every pipe in your data is escaped to \|.
Newlines inside a quoted CSV field are collapsed to spaces, because a Markdown table row cannot span lines. Nothing else about your values is touched.
If the CSV came from a Google Sheet
Skip the export. Paste the sheet URL directly and get the Markdown table without downloading a file first.
Frequently asked questions
What happens to a pipe character in my data?
It is escaped to \| so it cannot break the table. An unescaped pipe inside a cell terminates the column early and silently corrupts every row after it, which is the single most common bug in hand-rolled Markdown table converters.
Will the table render on GitHub?
Yes. The output follows the GitHub Flavored Markdown table extension, which GitLab, Notion, Obsidian and most static-site generators also implement. Paste it into a README or a pull request description and it renders as a table.
What about newlines inside a cell?
They are collapsed to spaces. A Markdown table row has to live on a single line, so a multi-line cell has no representation — collapsing keeps the content while preserving the table, which is the least-bad option available.
Sources
Related tools
Free CSV to JSON Converter Online
Paste CSV and get formatted JSON back — one object per row, keyed by the header row. Quoted fields, embedded commas and newlines all handled. Free, no signup.
Google Sheets to Markdown Table Converter
Turn a Google Sheet into a Markdown table for a README, a doc, or an AI prompt. Free, instant, no signup — pipes inside your cells are escaped for you.
Free JSON to CSV Converter Online
Paste a JSON array of objects and get CSV back, header row built from the keys. Values holding commas or quotes are escaped properly. Free, no signup.
Turn your sheet into an API in minutes
Paste a Google Sheet URL and get a live REST API and MCP server — no backend, no code, free to start.