CSV to Markdown Table
Convert CSV, TSV or cells copied from Excel or Google Sheets to a GitHub Markdown table with column alignment and padded pipes. Free, in your browser.
How to use CSV to Markdown Table
- 1Paste CSV or TSV, copy cells from Excel or Google Sheets, or open a file.
- 2Choose alignment (auto, left, centre or right), the header row and whether to pad the columns.
- 3Copy the Markdown or download it as table.md.
What makes it better
- Separator detected automatically: comma, semicolon, tab or pipe
- Auto alignment puts numbers on the right and text on the left
- Optional padding so the pipes line up in the source
- Pipes inside cells are escaped and line breaks become <br>
- Rendered preview built from plain text nodes
About CSV to Markdown Table
CSV to Markdown Table converts delimited text into a GitHub-flavoured Markdown table for READMEs, issues, pull requests and docs. Comma, semicolon, tab and pipe separators are detected automatically, so cells copied straight from a spreadsheet work. It goes one way, from CSV to Markdown, and shows a rendered preview beside the source.
Common uses
- Add a results table to a GitHub README from a spreadsheet range.
- Paste benchmark numbers into a pull request description as a readable table.
- Turn a CSV export into a table for a documentation site that uses Markdown.
- Format a short comparison for a wiki page or chat message.
Example
Input
name,qty,price Apple,3,1.20 Banana,12,0.5
Result
| name | qty | price | | ------ | --: | ----: | | Apple | 3 | 1.20 | | Banana | 12 | 0.5 |
Good to know
- Markdown tables cannot hold block content, so line breaks inside a cell become <br>, which GitHub renders but some other Markdown tools show literally.
- Rows with fewer cells than the widest row are padded with empty cells, and a notice says how many were affected.
- Column width is counted in characters, so wide characters such as CJK or some emoji may look slightly misaligned in a monospace font. The table still renders correctly.
CSV to Markdown Table FAQ
Can I paste cells straight from Excel or Google Sheets?
Yes. Copied spreadsheet cells arrive tab-separated, and the tool detects the tab automatically. Paste them into the box and the Markdown table appears with the first row as the header.
How does the Auto alignment decide left or right?
A column is right-aligned when every non-empty body cell looks like a number (plain, with thousands commas, decimals, exponent or a percent sign). Any other column is left-aligned. Pick Left, Centre or Right to force every column.
What happens to a pipe character or a line break inside a cell?
A pipe is written as \| so it does not split the cell, and a line break is replaced by <br>. Both are valid in GitHub-flavoured Markdown tables.
My data has no header row. What should I do?
Turn off First row is the header. Markdown tables must have a header line, so the tool writes an empty header row and keeps every row of your data in the body.
Why turn off Pad columns?
Padding makes the source easy to read but makes diffs noisier when one long value changes the width of a whole column. Without padding each row is as short as possible and renders identically.