Convert CSV to Markdown Table Online
Turn CSV into a Markdown pipe table, padded so it also reads well as plain text. The CSV is read in your browser and never uploaded.
Drop a CSV or Excel file here
CSV · XLSX · XLS · XLSM · XLSB
Ready to download as a binary file.
How to convert CSV or Excel to a Markdown table
Three steps from deps.csv to a Markdown table.
1. Paste or drop the CSV
Paste CSV text or drop a .csv, .tsv or .txt file; the delimiter is detected.
2. Check it in the grid
Keep cells short: Markdown tables don't wrap in the source, so one long value widens the whole column.
3. Pick a style
Pretty (padded columns) or compact, column alignment, optional bold header, escaping; then copy or download data.md.
Example: CSV in, Markdown out
A dependency list for a README, with an underscore in a header, backticks in a note and an empty cell.
package,version,min_node,notes
express,4.19.2,18,
vite,5.2.0,18,run with `npx vite`| package | version | min\_node | notes |
| :------ | :------ | :-------- | :-------------------- |
| express | 4.19.2 | 18 | |
| vite | 5.2.0 | 18 | run with \`npx vite\` |Escaping adds backslashes: min_node is written as min\_node, and the backticks around npx vite are escaped, so the note shows them literally instead of as code. Untick Escape special chars to get inline code.
What changes between CSV and Markdown
Pipe table
The output is a GitHub Flavored Markdown table. Pretty pads every column to the width of its longest value (4 columns here), so the source reads like a table too; Compact skips the padding and keeps diffs small.
Escaping
| is always escaped as \|, and with Escape special chars ticked so are *, _ and `. Here the value min_node is written as min\_node. It renders as the original text; untick the option if the cells contain Markdown you want rendered.
CSV values are plain text
CSV has no types, so the grid gets every value exactly as written, and the Markdown keeps them that way.
When to convert CSV to Markdown
- Adding a data table to a README, a GitHub issue or a pull request description.
- Writing docs in Obsidian, MkDocs or Docusaurus from data that lives in a spreadsheet.
CSV to Markdown in JavaScript
TabularJS reads the CSV into a 2D array. Then each row is joined with pipes.
import tabularjs from 'tabularjs';
// CSV values are strings; the header row stays in data[0]
const { worksheets } = await tabularjs('deps.csv');
const [header, ...rows] = worksheets[0].data;
const cell = (v) => String(v ?? '').replace(/\|/g, '\\|').replace(/\n/g, '<br>');
const line = (cells) => '| ' + cells.map(cell).join(' | ') + ' |';
console.log([line(header), line(header.map(() => '---')),
...rows.map((row) => line(header.map((_, i) => row[i])))].join('\n'));TabularJS returns CSV values as strings and leaves the header in data[0]. It does not guess the delimiter: comma is the default, so pass { delimiter: ';' } for semicolon files.
Frequently asked questions
Will the table render on GitHub?
Yes. GitHub, GitLab and most Markdown editors render pipe tables. Renderers that implement strict CommonMark without the tables extension show the raw pipes instead.
Can I make the table shorter in the source?
Choose Compact: cells are separated by single spaces without padding, which keeps the source short and diffs readable when values change.
Are quoted fields with commas or line breaks handled?
Yes. A field in double quotes can contain the delimiter, doubled quotes ("") and line breaks, and it still ends up in one cell. In the Markdown table a line break is written as <br>.
Where will this table render?
Anywhere that supports GitHub Flavored Markdown tables: GitHub, GitLab, Bitbucket, Obsidian, VS Code preview, MkDocs, Docusaurus and most static site generators. Strict CommonMark without the tables extension shows raw pipes.
Does deps.csv get uploaded when I convert it to Markdown?
No. The CSV is read in your browser and never uploaded.