Markdown Table Generator

This Markdown table generator turns a grid of cells, typed or pasted from a spreadsheet, into a table you can copy into any Markdown file. Drafting the rest of the document? The free online notepad is one click away.

From Excel, Google Sheets, CSV or an existing Markdown table.

Table

Header

3 rows and 3 columns. Up to 500 rows and 30 columns.

Preview

Add some cells first.

Saved only in this browser under the key qn-mdtable-v1. Nothing you type is sent anywhere. Clearing this site's data deletes it.

Why use our Markdown Table Generator?

Paste From a Spreadsheet

Copy a range in Excel or Google Sheets and Import turns it into rows and columns.

Alignment per Column

Set left, center or right for each column from its menu; the colons in the delimiter row are written for you.

Pipes Escaped for You

A pipe or a line break typed in a cell is written so it cannot break the table.

What is a Markdown Table Generator?

A markdown table generator turns a grid of cells into the pipe syntax Markdown uses for tables, so you edit cells instead of counting pipes and hyphens. Type into the grid, paste from a spreadsheet or CSV, or paste an existing Markdown table to edit it.

Tables are an extension in GitHub Flavored Markdown. They are not part of original Markdown or CommonMark, so a renderer without the extension shows the pipes as plain text. Check the preview where you paste the table before you publish it.

Markdown Table Syntax, Explained

  • Header row:The first line is the header row. Pipes separate the cells.
  • Delimiter row:The second line is the delimiter row: at least three hyphens per column. Colons set alignment: :-- left, :-: center, --: right.
  • Pipes and breaks:A pipe inside a cell is written \|, so it does not end the cell. A line break inside a cell becomes <br>.
  • Uneven rows:Rows with fewer cells get empty cells, and extra cells are ignored. Padded and compact output render the same table.
  • Source:These rules come from the GitHub Flavored Markdown tables spec.

Common Use Cases

README Tables

List options, commands or supported versions in a README without lining up pipes by hand.

From a Spreadsheet

Copying a range in a spreadsheet puts tab-separated text on your clipboard, and Import reads it as rows and columns.

CSV Exports

A CSV paste works too: quoted cells keep their commas and line breaks, so CSV to Markdown table conversion needs no clean-up first.

Editing Old Tables

You can also paste an existing Markdown table to edit it; its column alignment comes back with it.

HTML Tables

Need an HTML table instead? Use the CSV to HTML table converter.

The Rest of the Document

To write the rest of the document with a live preview, use the Markdown editor.

How to Make a Markdown Table

1

Fill the grid

Type into the grid, or paste cells into Paste a table and press Import.

2

Keep a header

Keep the first row as the header. Markdown tables always have one.

3

Align columns

Set each column's alignment from its options menu.

4

Copy or download

Press Copy Markdown, or Download .md to save a file.

Benefits of Using a Markdown Table Generator

No Pipe Counting

The delimiter row and every pipe are written for you, so the table renders the first time.

Readable Raw Text

Padded output lines the columns up so the raw Markdown is easy to read, while Compact output keeps it short.

Round Trip Safe

Padded and compact output both import back into the same grid, so you can edit a table again later.

Row and Column Tools

Add rows and columns with their buttons, then move or delete them from their menus. Undo brings back a deleted one.

Kept for Later

Your table is saved in this browser, so a half finished table is still there next time.

Tips for Markdown Tables

  • •Limits: Imports keep up to 500 rows and 30 columns.
  • •Merged cells: Markdown tables have no merged cells, so split the content across columns instead.
  • •Line breaks: Type a line break in a cell when you need one; GitHub renders the written <br> as a break.
  • •Storage key: The grid is kept in this browser under the key qn-mdtable-v1 until you clear this site's data.

Build Your Table

Start typing in the grid above, or paste a range from your spreadsheet and press Import.

Copy the Markdown when it looks right and paste it into your README, docs or notes.

Example Markdown Table

The header row, the delimiter row with left, right and center alignment, an escaped pipe and a line break written as <br>:

| Item | Price |    Note    |
| :--- | ----: | :--------: |
| Tea  |     3 | Hot\|iced  |
| Cake |  4.50 | one<br>two |

Related tools

Frequently Asked Questions

Can I paste an Excel or Google Sheets range?

Yes. Copy the cells, paste them into Paste a table and press Import.

Can I set different alignment per column?

Yes. Left, center or right, written as colons in the delimiter row.

Can I merge cells in a Markdown table?

No. GitHub Flavored Markdown tables have no merged cells.

How do I add a line break inside a table cell?

Type it in the cell. The output writes it as <br>, which GitHub renders as a break.

Does column padding affect the rendered table?

No. Padding only makes the raw text easier to read; Compact output removes it.

Is this Markdown table generator free?

Yes, with no account. Your table is saved in this browser under the key qn-mdtable-v1.