Markdown Table Generator

TL;DR

The markdown table generator turns table data into GitHub- and Notion-compatible markdown table syntax (pipe | separated).

The first line becomes the header, and a separator line (---) that sets the alignment is added automatically as the second line.

Each line is one row. Cells are split by the separator chosen below. (Copying from Excel/Google Sheets uses tabs.)

How to use

  1. Enter data — put one row per line and separate cells with a tab or comma. The first line becomes the table header.
  2. Choose alignment — pick left, center or right alignment to set the column alignment markers.
  3. Copy result — copy the generated markdown table and paste it into GitHub, Notion, a blog and more.

Markdown table syntax basics

A markdown table separates cells with pipes (|) and puts a separator line made of hyphens (-) under the header. Add colons (:) to the separator to set column alignment.

Alignment separator notation
AlignmentSeparator notationMeaning
Default---Renderer default (usually left)
Left:---Left aligned
Center:-:Center aligned
Right---:Right aligned

For more detail and tips to keep tables from breaking, see our complete markdown table syntax guide.

Frequently Asked Questions (FAQ)

Should I separate cells with tabs or commas?

The default is tab (compatible with spreadsheet copy), but you can also choose comma or pipe (|). Copying cells from Excel or Google Sheets produces tab-separated values, so you can paste them directly.

Can a markdown table cell contain a pipe (|) character?

A pipe inside a cell conflicts with the table separator, so it is automatically escaped to \| with a backslash. That way a pipe character inside a cell will not break the table.

Is the first line always the header?

Yes. In markdown table syntax, the first line is the header and the second line is the separator. This tool uses the first line you enter as the header.

Where can I paste the generated table?

You can paste it almost anywhere that supports markdown, including GitHub README files, Notion, Obsidian, Discord and static blogs.

Related tools & guides

Last updated: 2026-06-25