How to use the Markdown Table Generator
- 1. Paste the dataCopy cells from Excel or Google Sheets, or paste CSV.
- 2. Set alignmentWrite left, center or right for each column.
- 3. Copy the tableGenerate and paste into your README, docs or notes.
Markdown table syntax
A Markdown table is rows of cells separated by pipes, with a separator line under the header:
| Tool | Use | Price |
| --- | --- | :---: |Colons in the separator set alignment: :--- is left, :---: is centred and ---: is right. Writing this by hand is slow and easy to get wrong, especially lining up columns. This tool does it for you and can pad every cell so the raw text also lines up neatly, which keeps diffs readable in Git.
Worked example
The sample has a header (Tool, Use, Price) and 3 rows, so the result is a 3 rows × 3 columns table. With alignment left, left, center, the separator line is | ------- | --------------- | :-------: |, with colons on both ends of the third column only. With padding on, each column is as wide as its longest value, so Version control and Free plan line up exactly.
- Pipes inside your data are escaped as \| so they don't create extra columns.
- Copied Excel cells are tab-separated, which the tool detects automatically.
- Short rows get empty cells, so every row has the same number of columns.
Tables render on GitHub, GitLab, Notion, Obsidian and most static site generators. Plain CommonMark without extensions does not support tables.
Frequently asked questions
Where do Markdown tables work?
GitHub, GitLab, Bitbucket, Notion, Obsidian, Jira and most docs tools support GitHub-flavoured tables.
Can a cell have a line break?
Not in standard Markdown tables. Some platforms accept
inside a cell.
Is padding required?
No, it only makes the raw text easier to read. Tables render the same without it.
Is the markdown table generator free?
Yes, it is free. Generating your first table asks for your name and WhatsApp number once, and after that the markdown table generator and every other Uncodemy tool open without the form.