All tools
Free · Private · No upload

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

or paste your data below

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.

deps.csv
package,version,min_node,notes
express,4.19.2,18,
vite,5.2.0,18,run with `npx vite`
data.md (default options)
| 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

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.

npm install tabularjs MIT licensed

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.