CSV to Markdown

Convert CSV to Markdown instantly in your browser.

Local Your input is processed locally in your browser. Found a problem? Report an issue

What CSV to Markdown does

CSV to Markdown reads CSV and writes it as Markdown. The input is parsed first, so a syntax error is reported with its position instead of producing broken output.

CSV is a plain-text table: one row per line, values separated by commas. Every spreadsheet opens it. A Markdown table is the pipe-separated table syntax that GitHub, GitLab, Notion, Obsidian and most documentation tools render as a real table.

CSV to Markdown example

Input

id,name,city
1,Ada,London
2,Lin,Bengaluru

Output

| id | name | city |
| --- | --- | --- |
| 1 | Ada | London |
| 2 | Lin | Bengaluru |

The output is what this tool produces for the input above it.

How it works

Reading CSV. The first line is the header. Quoted values may contain commas, quotes and line breaks.

Writing Markdown. The first row holds the column names, the second the --- separators, and each record is one row. A pipe character inside a value is escaped as \| and a line break becomes <br>, so the table never breaks.

Details and limits

  • Everything runs on your device, so there is no upload and no fixed size limit; very large inputs depend on its memory.
  • It works in current browsers on phones, tablets and computers, and it is free with no account.
  • Values are written as plain text; Markdown formatting inside a cell, such as **bold**, is kept as written.

Worked example: Turning a 4-row API benchmark CSV into a GitHub Markdown table

Suppose you export benchmark results from a spreadsheet as CSV, including a quoted cell that contains a comma and a literal pipe character:

Endpoint,Method,P95 Latency (ms),Notes
/api/v2/users,GET,18.4,"Cached in Redis, TTL 60s"
/api/v2/orders,POST,94.2,Writes to primary | replica

When you convert this CSV with First row is header checked, the parser respects the RFC 4180 quotes around "Cached in Redis, TTL 60s" (keeping it in Column 4 instead of splitting on the comma) and escapes the literal pipe as \| so it does not break the Markdown table column count:

| Endpoint | Method | P95 Latency (ms) | Notes |
| --- | --- | --- | --- |
| /api/v2/users | GET | 18.4 | Cached in Redis, TTL 60s |
| /api/v2/orders | POST | 94.2 | Writes to primary \| replica |

Limits and what this tool cannot do

  • GitHub Flavored Markdown (GFM) tables do not support merged cells (colspan / rowspan): Every row in a Markdown pipe table must have the exact same number of cells as the header row.
  • Multi-line cells with line breaks: Standard Markdown pipe tables require each row to sit on a single line in the source .md file; newline characters inside a quoted CSV cell are converted to spaces (or <br> if HTML is supported by your Markdown renderer).
  • No spreadsheet formula evaluation: Formulas like =AVERAGE(C2:C10) are output as literal text strings.

Questions

Is my data uploaded?

No. The conversion runs in your browser.

Is CSV to Markdown free?

Yes, with no sign-up and no limit on use.

How do I right-align or center-align a numeric column in the Markdown output?

In the separator row (| --- |), add a colon on the right (---:) for right alignment, or colons on both sides (:---:) for center alignment.

What if my file is tab-separated (TSV) or semicolon-separated instead of comma-separated?

Select Tab or Semicolon in the delimiter dropdown (or let auto-detection inspect the first line) so columns split on the right character.

Why did the converter put a backslash before the | character inside my text?

In Markdown tables, an unescaped | marks a column boundary. Escaping literal pipe characters inside cell text as \| prevents your row from splitting into extra columns.