CSV to Markdown Table Converter

Paste CSV or choose a file and get a Markdown table ready for a README or wiki. It runs in your browser.

  • Runs in your browser
  • No sign-up
  • No watermark

This tool turns CSV into the pipe table syntax used by GitHub Flavoured Markdown. Pipe characters inside cells are escaped, line breaks inside cells become br tags, and quoted fields are read correctly. You can align columns left, centre or right, let the tool right align columns that contain only numbers, and pad the columns so the plain text source lines up.

Markdown tables always need a header row. If your data has none, the tool writes an empty header. Other Markdown characters in your cells, such as asterisks or underscores, are left as they are and may be formatted when the table is shown. Padding counts characters, so wide characters such as Chinese or emoji can look slightly out of line in a plain text editor. Files up to 50 MB are accepted and nothing is uploaded.

How to use CSV to Markdown Table

  1. Choose a CSV file, or paste the CSV text into the box.
  2. Pick the delimiter and the column alignment, and say whether the first row is the header.
  3. Choose whether to pad the columns so the source lines up.
  4. Select Copy to paste the table into your Markdown, or Download to save an .md file.

Frequently asked questions

Is my CSV uploaded anywhere?

No. The conversion runs in your browser and the data is never sent to a server.

How are pipe characters handled?

A pipe inside a cell is written as a backslash and a pipe, which GitHub shows as a normal pipe character instead of starting a new column.

What happens to line breaks inside a cell?

Markdown tables must stay on one line per row, so each line break becomes a br tag by default. If you switch that off, the break is replaced by a space.

How does automatic alignment work?

A column is right aligned when every non-empty cell in it looks like a number, including signs, thousands commas, decimals, percentages and a leading currency symbol. All other columns are left aligned. The header cell is not used for this check.

Does padding change how the table looks?

No. Markdown ignores the extra spaces when it renders the table. Padding only makes the plain text easier to read and edit.

What if my CSV has no header row?

Untick the header option. The tool then writes an empty header row, because a Markdown table cannot exist without one.

Are other Markdown characters escaped?

No, only the pipe. Characters such as asterisks, underscores, brackets and angle brackets in your cells are left as typed, so they may be treated as formatting when the table is displayed.