Markdown table generator

Markdown tables are great for README files, documentation and pull requests, but typing the pipes and dashes by hand and keeping columns aligned is tedious. This generator builds a GitHub-flavored Markdown table from a grid or from pasted CSV or spreadsheet data, with optional column alignment.

How to use it

1. Enter rows and columns, or paste CSV or cells copied from Excel or Google Sheets.
2. Mark the first row as the header.
3. Set the alignment for each column.
4. Copy the Markdown.

Example

Input CSV:

Plan,Price,Users
Free,0,1
Team,29,10

Output:

| Plan | Price | Users |
| :--- | ----: | :---: |
| Free |     0 |   1   |
| Team |    29 |  10   |

Alignment syntax

• :--- left aligned (default)
• ---: right aligned, ideal for numbers
• :---: centred

Rules and limitations

• Every table needs a header row and a separator row.
• Padding spaces are optional; they only make the source easier to read.
• A literal pipe character inside a cell must be escaped as \|.
• Cells cannot contain block elements such as lists or code blocks. Use <br> for line breaks on GitHub.
• Inline formatting such as bold, links and inline code works inside cells.

Tip

Very wide tables are hard to read in Markdown source and on mobile. Split them into several smaller tables, or link to a CSV file for large datasets.