CSV ↔ Markdown Table Converter
Convert CSV data into a Markdown table, or a Markdown table back into CSV.
Category: Converters
When to use?
Use it to convert CSV exported from a spreadsheet into a Markdown table for a GitHub README, or to extract table data from a Markdown document as CSV for editing in Excel.
How to use
- Choose the direction (CSV → Markdown or Markdown → CSV).
- Paste the data.
- Copy the result.
Input Explanation
Paste comma-separated CSV text, or Markdown table data in | cell | cell | format.
Calculation Basis
For CSV, it joins the first line with the header separator (|---|---|) and wraps each row's items with pipe (|) delimiters into Markdown table syntax.
Usage Examples
- Write README tables - Convert CSV data into a Markdown table for a GitHub README.
- Extract document table data - Convert a Markdown table to CSV to tidy in a spreadsheet.
- Tidy table data both ways - Move between Markdown tables and CSV to edit in documents and spreadsheets.
Examples
- CSV: name,age\nJohn,30 → | name | age |\n|---|---|\n| John | 30 |
- Paste a Markdown table and pick CSV → extract the table data as CSV
Cautions
- Malformed source data can cause parsing errors or broken output.
- A mismatched encoding standard or complex nested data may break or drop the structure.
Guides
CSV to a Markdown table
Paste CSV data to convert it to Markdown | table syntax. The first line is recognized as the header and a header separator (|-|) is inserted automatically.
Markdown to CSV
Conversely, export a Markdown table as CSV to paste directly into a spreadsheet. Cells with commas or line breaks are wrapped in quotes.
FAQ
Can the first line be used as the header?
Yes, you can choose to use the first line as the header for CSV → Markdown.
How are pipe characters in cells handled?
Pipe characters are escaped so the Markdown does not break.
Can I change the delimiter?
An option handles data using delimiters other than commas.
Are empty cells allowed?
Yes. Empty cells stay blank so the table structure is not broken.
Related Tools
- Excel Paste → Markdown - Convert table-form text into a Markdown table.
- Markdown Table → HTML - Convert a Markdown table into an HTML table.
- CSV ↔ JSON Converter - Convert CSV and JSON array data bidirectionally.
- Markdown Table Generator - Set columns and rows and enter content to generate Markdown table syntax instantly.
- Markdown Preview - Render Markdown in real time and provide an HTML preview.
- URL Encode / Decode - Encode text into URL-safe form (%XX) or decode an encoded URL back to text.