📋 CSV to Markdown Table Converter

What is the CSV to Markdown Table?

A Markdown table is plain text that a renderer turns into a grid. It needs exactly three things: a header row, a separator row made of dashes, and at least one data row, with every cell wrapped in pipe characters. For example, the row | Name | Role | followed by | --- | --- | tells the renderer that Name and Role are column headings. This syntax is part of GitHub Flavored Markdown (GFM) and is supported by GitHub, GitLab, Bitbucket, most static site generators, and many note apps such as Obsidian and Notion. There must be at least three dashes per column in the separator row, and you should leave a blank line before the table so it renders correctly.

CSV (comma-separated values) stores the same tabular data but in a different shape: rows are separated by line breaks and cells by a delimiter, usually a comma. The catch is that real-world CSV is not simply "split on commas." A cell can be wrapped in double quotes to protect a comma or a line break inside it, and a literal double quote is written as two doubled quotes ( "" ). This converter follows those RFC 4180 rules, so a value like "Lovelace, Ada" stays in one cell instead of splitting into two, and a quoted "3.5"" screen" keeps its inch mark.

Not every file uses a comma. Exports from European versions of Excel often use semicolons because the comma is a decimal separator there, database dumps frequently use tabs (making them TSV files), and some log formats use pipes. That is why the delimiter is a setting rather than a guess. Choosing the wrong delimiter is the single most common reason a converted table collapses into one column, so match the delimiter to your source before you convert.

The pipe character needs special care. In Markdown a pipe ( | ) marks a column boundary, so any pipe that appears inside your data has to be escaped as a backslash-pipe ( \| ), otherwise it silently creates extra columns and breaks the layout. This tool escapes pipes for you. Line breaks inside a cell are converted to a line-break tag, because a Markdown table row must stay on a single physical line; GFM renderers show that tag as a real line break, while plain-text viewers show the literal tag.

Column alignment is controlled entirely by the separator row. Plain dashes ( --- ) leave a column at the renderer default (left). Adding a colon changes it: :--- forces left, :---: centers, and ---: aligns right. Right alignment is the convention for numeric columns such as prices, counts, and percentages, because it lines up the digits by place value and makes the numbers easy to scan. You can set one alignment for the whole table here, then hand-tune individual columns in the output if you need a mix.

Because the entire conversion happens locally in JavaScript, the tool works offline once the page has loaded and never uploads your data. That makes it safe for internal spreadsheets, customer lists, or any data you would not paste into a server-side converter. If you later need to go the other way, a Markdown table is easy to read back into CSV by stripping the pipes and the separator row.

When to use it

• Dropping a spreadsheet export into a GitHub README, issue, or pull request as a tidy table.
• Documenting API parameters, config options, environment variables, or test results in Markdown without hand-typing pipes.
• Converting data copied from Excel or Google Sheets (paste as tab-delimited) into docs-friendly Markdown.
• Building tables for static site generators such as Hugo, Jekyll, Astro, and Docusaurus that accept GFM.
• Turning a database query result or CSV log into a readable table for a wiki, Notion, or Obsidian note.
• Setting per-column alignment (left, center, right) for numeric or label columns in a single step.

How to use the CSV to Markdown Table

1. Paste your CSV into the box, with the column headings on the first line.
2. Pick the delimiter your file uses: comma, semicolon, tab, or pipe.
3. Choose a column alignment: default (left), left, center, or right.
4. Leave "First row is a header" ticked if your data starts with column names; untick it if it does not.
5. Press Convert to Markdown, review the preview, then use Copy to grab the table source.
6. Paste the result into your README, issue, wiki, or note where a blank line precedes it.

Formula & method

Worked examples

Markdown separator tokens by column alignment

Characters this converter handles specially

Common delimiters and where they come from

Common mistakes to avoid

• Forgetting that the first row is treated as the header. By default the first CSV line becomes the table header and gets the separator row beneath it. If your data has no headings, untick "First row is a header" so every line is treated as data.
• Picking the wrong delimiter. If your export uses semicolons or tabs but the tool is set to comma, the whole table collapses into one column. Match the delimiter to your file before converting. European Excel files usually use semicolons.
• Leaving raw pipes in cells when editing by hand. A pipe inside a value starts a new column in Markdown. This tool escapes pipes for you, but if you edit the output later, remember to write \| for a literal pipe.
• Expecting multi-line cells to stay on multiple lines. A Markdown table row must be a single line, so a line break inside a cell is converted to a line-break tag. GFM renderers show it as a line break; plain-text viewers show the literal tag.
• Forgetting the blank line before the table. Most renderers need a blank line above a Markdown table, otherwise it merges with the paragraph before it and renders as plain text. Paste the table with an empty line in front of it.
• Assuming every column can have its own alignment automatically. This tool applies one alignment to all columns. If you need a mix, for example left labels and right-aligned numbers, edit the colons in the separator row of the output by hand.

Glossary

CSV

Comma-separated values: a plain-text format where rows are lines and cells are split by a delimiter such as a comma.

TSV

Tab-separated values: the same idea as CSV but cells are split by tab characters, which is what you get when you copy from Excel or Google Sheets.

Markdown table

A table written in Markdown using pipes for column borders and a row of dashes to separate the header from the body.

GFM

GitHub Flavored Markdown, the Markdown dialect used by GitHub and many tools that adds table support.

Delimiter

The character that separates cells in a CSV file, most often a comma, but sometimes a semicolon, tab, or pipe.

Separator row

The row of dashes under the header that defines the columns and, with colons, their alignment.

Alignment token

The colon-and-dash pattern (:---, :---:, ---:) in the separator row that sets a column to left, center, or right.

RFC 4180

The common specification for CSV that defines how quotes, commas, and line breaks inside cells are handled.

Frequently asked questions