CSV to Markdown Table Converter
Convert CSV to markdown table and markdown tables back to CSV. Auto-detects delimiters, handles quoted fields and header rows. Free, no signup.
| name | department | start date | salary | | ----------- | ----------- | ---------- | ------ | | Rivera, Ana | Engineering | 2021-03-15 | 98000 | | Ben Okafor | Design | 2019-11-02 | 81000 | | Chen Wei | Marketing | 2022-06-20 | 72500 |
What Is a CSV to Markdown Converter?
A CSV to markdown converter reads comma-separated (or tab-separated) values and writes them out as a markdown pipe table with a header line, a separator line and one row per record. The same fields that a spreadsheet would show in cells become the cells of the table, so the data renders correctly on GitHub, in documentation sites and in note apps.
This tool works in both directions. Paste CSV to get a csv to markdown table conversion with alignment and padding, or paste an existing table to get CSV that Excel, Google Sheets, pandas and SQL importers accept. Nothing is uploaded; parsing happens in your browser.
How to Convert CSV to a Markdown Table
- Paste your CSV or TSV into the left pane, or click Open file to load a .csv or .tsv from disk.
- Check the delimiter. Auto-detect handles commas, tabs, semicolons and pipes; pick one manually if the guess is wrong.
- Leave First row is header on when the first line contains column names.
- Choose an alignment for all columns. Right alignment is the usual choice for numeric data.
- Copy the markdown table from the right pane or download it as table.md.
Delimiters and Quoting Reference
CSV is loosely specified, so exports differ between programs. The converter handles these variations:
| Input | Typical source | Handling |
|---|---|---|
| Comma delimited | Excel, Google Sheets, most APIs | Default; detected automatically |
| Tab delimited (TSV) | Copy-paste from spreadsheets, database tools | Detected; tabs never appear in cells |
| Semicolon delimited | Excel in European locales | Detected; decimal commas stay intact |
| Quoted fields | Names, addresses, free text | Quotes removed, inner delimiters kept |
| Doubled quotes ("") | RFC 4180 escaping | Become a single quote character |
| Pipe in a value | Regex, shell commands | Escaped as \| in the markdown |
| UTF-8 BOM | Excel "CSV UTF-8" export | Stripped from the first header |
| Blank lines | Trailing newline, spacing | Skipped |
Markdown to CSV: The Reverse Direction
Markdown to CSV takes the first pipe table it finds in the text, ignores the alignment line, unescapes any \| sequences and writes the cells with the delimiter you choose. Pick Tab when you plan to paste straight into a spreadsheet, because tab-separated text lands in separate cells without an import dialog. Untick Include header line when the target is a database load that expects data rows only. Alignment is not part of CSV, so it is dropped; the values themselves are unchanged.
Why Convert CSV to Markdown
A csv to table conversion is the quickest way to show data in a place that only accepts text: a README, a pull request description, a GitHub issue, a Slack canvas or an LLM prompt. Markdown tables are diffable, searchable and readable in the raw file, which CSV is not once columns get wide. Use the CSV to markdown converter for exports from analytics tools, benchmark results and configuration matrices, then keep the table tidy with the markdown table formatter when the data changes.
Frequently Asked Questions
How does the CSV to markdown converter detect the delimiter?
It samples the first lines and counts how consistently each candidate character (comma, tab, semicolon, pipe) splits them into the same number of fields. The detected delimiter is shown in the Delimiter menu, and you can override it when a file uses an unusual separator.
What happens to commas inside quoted fields?
They stay inside the cell. The converter follows RFC 4180 quoting rules, so "Smith, John" becomes one cell and a doubled quote ("") becomes a literal quote character. Newlines inside quotes are converted to <br> so the markdown row stays on one line.
My CSV has no header row. What should I do?
Untick First row is header. A markdown table always needs a header line, so the tool emits an empty one and keeps all of your lines as data rows. You can then type column names into the empty header before pasting.
Can I convert a markdown table back to CSV?
Yes. Switch the direction to Markdown to CSV, paste the table, and choose a comma, tab, semicolon or pipe delimiter. Cells that contain the delimiter or quotes are quoted automatically so the file opens correctly in Excel or Google Sheets.
Is there a size limit?
There is no fixed limit because the conversion runs in your browser. Tables with tens of thousands of rows convert in well under a second; the practical limit is how much markdown your target platform will render.