CSV to Markdown Table
Turn CSV or TSV data into a GitHub-flavored Markdown table for READMEs, docs and issues.
Paste or drop
Paste text below, or drop a file instead.
Choose an output
Turn CSV or TSV data into a GitHub-flavored Markdown table for READMEs, docs and issues.
Fine-tune
Optional — sensible defaults are already set.
About CSV to Markdown Table
This tool turns CSV or TSV data into a GitHub-flavored Markdown pipe table you can paste into a README, wiki, pull request or issue. Pipe characters in your data are escaped and line breaks inside cells become <br>, so the table doesn't break. You can upload a file or paste data copied from a spreadsheet.
When it helps
- Adding a feature comparison or config reference table to a project README.
- Posting benchmark results or test data in a GitHub issue or pull request.
- Writing tables for Markdown-based docs sites, Obsidian notes or Notion imports.
Tips
- Turn off "First row is a header" when your data has no header row. The table then gets generic Column 1, Column 2 headings that you can rename.
- Short rows are padded with empty cells, so ragged CSV still produces a valid table.
- Columns are left-aligned by default. To right-align numbers, change the --- under that heading to ---: after pasting.
Good to know
Quick answers about csv to markdown table in your browser.
Pipe tables are part of GitHub-flavored Markdown and work on GitHub, GitLab, most static site generators and many note apps. Original Markdown didn't define tables, so a few older renderers show them as plain text.
Markdown table rows must be on one line, so line breaks inside a CSV field are replaced with <br>, which GitHub renders as a line break inside the cell.
Yes. There is no sign-up, no watermark and no limit on how many files you process.
No. Files are read and processed locally in your browser, so they never leave your device.
Related tools
Part of the CSV Tools collection.