Skip to content
ViewMarkdown

The first row is the header. Markdown tables always have one, and the dashes underneath set each column’s alignment.

Markdown

Preview

Feature Free Pro
Live preview Yes Yes
Export to Word Yes Yes

Markdown table generator

Type into the grid, set each column's alignment, copy the Markdown. Or paste CSV and let it fill itself.

Writing a Markdown table by hand is fine for three columns and miserable for eight. Fill in the grid instead and the syntax is written for you, padded so the columns line up in the source and stay readable when someone opens the raw file.

Markdown tables always have a header row, so the first row of the grid is the header and the dashed line underneath sets the alignment. A colon on the left means left-aligned, colons on both sides mean centered, one on the right means right-aligned, and plain dashes leave it to the renderer.

Pipe tables are part of GitHub-flavored Markdown, which is what GitHub, GitLab, Obsidian, Notion, Slack canvases, Discord and most static site generators use. Merged cells, multi-line cells and nested tables are not part of it in any flavor. If you need those, you need HTML.

How it works

  1. Set the number of rows and columns, then type into the cells. Tab moves across a row, Enter drops to the cell below.
  2. Choose an alignment per column, or paste a block of CSV or TSV from a spreadsheet to fill the whole grid at once.
  3. Check the preview, then copy the Markdown. Pipe characters typed into a cell are escaped for you, so they will not break the row.

Frequently asked questions

What is the syntax for a Markdown table?

Separate cells with pipes and put a row of at least three dashes under the header: | Name | Role | then | --- | --- | then your rows. The outer pipes are optional in most renderers but make the source easier to read.

How do I align a column?

With colons in the dashed row. :--- is left, :---: is centered, ---: is right, and --- leaves the default. Pick an alignment per column above the grid and the generator writes the colons for you.

Can a Markdown table have merged cells?

No. Markdown has no equivalent of rowspan or colspan, and no flavor adds one. If you need merged cells, write that table in HTML, or keep the column and repeat the value.

Can I put a line break or a list inside a cell?

Not with plain Markdown. A cell is one line. Where raw HTML is allowed, a <br> tag works for a line break, but on sites that strip HTML it will not. Splitting the content into more rows is usually the better answer.

My table renders as plain text. What went wrong?

Usually a missing dashed separator row, a blank line between the header and the rows, or a renderer that does not support GitHub-flavored Markdown at all. Copying a fresh table from here rules out the first two.