CSV to Markdown Table

What this tool does

This tool turns CSV data into a Markdown table. You paste a CSV export — or drop a .csv file onto the page — and it produces a clean, GitHub-Flavored Markdown table that you can drop straight into a README, a wiki page, a pull request, a Notion doc or any other place that understands Markdown.

CSV (comma-separated values) is the plain-text format almost every spreadsheet and database can export: each line is a row, and the values in a row are separated by a comma (or sometimes a semicolon or a tab). A Markdown table is a different plain-text format — one designed so that the text also looks like a table when it is published. This tool bridges the two: spreadsheet data in, publishable table out. The page loads with a small sample so you can see the result immediately.

You get two views of the result. A live rendered preview shows the table the way a reader will see it, with borders and alignment. A code panel shows the raw Markdown text — that is what you actually copy and paste.

Why and when you would use it

Anyone who writes documentation runs into this. You have a table of figures in a spreadsheet — pricing tiers, a feature comparison, a list of campaign results — and you need it inside a document that is written in Markdown. Retyping the table by hand is slow and error-prone. Pasting a screenshot looks unprofessional and cannot be searched or copied.

Common uses include adding a results table to a project README, putting a comparison grid into a GitHub or GitLab wiki, dropping survey numbers into a Notion or Obsidian note, including a small data sample in a support article, or sharing a clean table in a pull-request description so reviewers can see the numbers without opening a spreadsheet. If you need the table as a real HTML grid instead, the related CSV to Table tool does that, and the Table Generator lets you build a table from scratch.

How to use it

1. Paste your CSV into the input box, or drop a .csv file onto the dropzone. The sample shows the expected shape.
2. Choose the delimiter. Auto-detect handles most files; switch to semicolon, tab or pipe if your export uses one of those.
3. Decide whether the first row is a header. If it is, leave the toggle on so those names become the column headings. If not, turn it off and generic Column 1…N headings are generated.
4. Pick a column alignment — left, center or right. This sets the colons in the separator row so the published table aligns its columns that way.
5. Keep “pad columns” on if you want the raw Markdown to line up neatly when read as plain text; turn it off for the most compact output.
6. Check the rendered preview, then use Copy Markdown or Download .md.

Common pitfalls and tips

Watch out for leading zeros. If a column holds ZIP codes, SKUs or phone numbers, Excel and Google Sheets often strip the leading zero — 01730 becomes 1730 — before you ever export the CSV. Fix that in the spreadsheet first, because this tool faithfully converts whatever the CSV actually contains.

Mixed delimiters are another trap. A file that looks comma-separated may actually use semicolons (common with European spreadsheet settings). If the preview shows everything crammed into one column, change the delimiter.

Very wide tables are hard to read in raw Markdown. If your table has many columns, the “pad columns” option makes the text version huge; turning it off keeps the source compact, and the rendered table looks the same either way. Finally, remember that a published Markdown table cannot merge cells or span rows — it is always a simple grid. If you need rich formatting inside cells, convert the Markdown to HTML afterwards with the Markdown to HTML tool.

Privacy

This converter runs entirely inside your browser. Your CSV is read, parsed and turned into Markdown by JavaScript on your own device — it is never uploaded, never stored and never logged. Closing the tab erases everything. That means you can safely convert exports containing customer records, revenue figures or unpublished data without it ever leaving your computer.