Free guide · table generator
How to make a Markdown table
A Markdown table is a header row, a row of dashes, then one line per row, with a pipe (|) between the cells.
Colons in the dash row line the columns up. Build one below with the free generator, or copy an example.
Markdown table generator
Type into the cells, pick each column's alignment, and the Markdown is written below as you go. Nothing leaves this page.
The three lines of a table
The header
The column names, with a pipe between each. Pipes at the two ends are optional, but they keep the table easy to read as text.
The dashes
One group of dashes under each column, between pipes. Three dashes each is the safe habit; this line is what tells a viewer the text above is a table.
The rows
One line per row, cells in the same order as the header. The pipes don't need to line up: spaces are only there to help you read it.
| Day | Task |
|-----|-------|
| Mon | Water |
| Wed | Weed |Aligning columns
Add colons to a column's dashes: a colon on the left aligns it left, a colon on the right aligns it right, and colons at both ends centre it. Right-align prices and counts so the digits line up.
| Item | Note | Cost |
|:------|:----------:|------:|
| Seeds | spring mix | $50 |
| Hose | 25 m | $34 |Bold, code and links inside a cell
Cells take the same inline marks as the rest of your text: bold, italic, code and links. A cell can't hold a list or a heading. To put a pipe inside a cell, write a backslash before it, or it will start a new cell.
| Tool | Note |
|------------|-------------------|
| **Viewer** | `free` |
| PDF | *no account* |
| Prices | [see](/pricing) |
| A pipe | a \| b |Where Markdown tables work
Tables are a GitHub-style extra to basic Markdown, so they show as tables on GitHub and in the markdownwise viewer, while a plain Markdown tool may print them as text. If someone sends you a file full of pipes and dashes, drop it in the viewer to read every table in rows and columns, with nothing uploaded.
Need it on paper? The Markdown to PDF converter gives tables ruled lines and a bold header row, and when a long table runs onto the next page its header comes with it. Going the other way, getting a table out of a PDF usually breaks it into loose lines; markdownwise's PDF to Markdown rebuilds it as a real table (it is in beta, so check complex tables).
Every other mark is in the Markdown cheat sheet.
Markdown table questions
How do you make a table in Markdown?
Write a header row with pipes between the column names, then a row of dashes under each column, then one line per row with the cells in the same order.
How do I align a column in a Markdown table?
Add colons to that column's dashes: :--- aligns it left, ---: aligns it right, and :---: centres it.
Can a Markdown table cell hold a list or a line break?
Not in standard GitHub-style tables: each row has to stay on one line, and a cell can't hold a list or a heading. Bold, italic, code and links do work inside cells.
Is there a free Markdown table generator?
Yes. The generator on this page writes the table as you type into the cells, with an alignment for each column, and nothing leaves your browser.
Why does my Markdown table show as plain text?
Usually the row of dashes is missing or has a different number of cells from the header, or the app does not support tables, which are a GitHub-style extra. Check it in the free Markdown viewer.