Markdown tables power documentation on GitHub, Notion, and Obsidian. Use our free Markdown Table Generator with visual editor and CSV import. Part of our Complete Developer Tools Guide.
Markdown Table Syntax
| Name | Age | City |
|------|-----|------|
| Alice | 30 | Mumbai |
| Bob | 25 | Delhi |Three elements: pipe-separated columns, a dash separator row, and data rows.
Visual Editor vs Manual Typing
Use the visual grid for small tables. Paste CSV for data exported from Excel or Google Sheets.
Column Alignment
- Left:
|:---| - Center:
|:---:| - Right:
|---:|
Converting CSV/Excel to Markdown
Copy cells from Excel (tab-separated), paste into the CSV mode, and click Parse. Related: JSON Formatter, Markdown to HTML.
Where Markdown Tables Are Used
GitHub READMEs, API documentation, Notion pages, Obsidian notes, Jekyll/Hugo static sites, and developer wikis.
Frequently Asked Questions
What is the Markdown table syntax?
A Markdown table uses pipe characters (|) to separate columns and a row of dashes (---) to separate the header from the data rows. Minimum syntax: | Header 1 | Header 2 | (newline) |---|---| (newline) | Data 1 | Data 2 |. Alignment is added with colons: |:---| for left, |:---:| for center, |---:| for right.
How do I add alignment to a Markdown table?
Add colons to the separator row (dashes row): |:---| aligns the column left, |:---:| centers it, and |---:| aligns right. Without a colon, the default is left-aligned.
Can I convert Excel or CSV data to a Markdown table?
Yes — copy your Excel data (which copies as tab-separated values) or any CSV, paste it into the CSV import area, and the tool converts it to a properly formatted Markdown table automatically.
Which platforms support Markdown tables?
Markdown tables are supported in GitHub (README.md, issues, PRs), GitLab, Bitbucket, Notion, Obsidian, Joplin, VS Code Markdown preview, Jekyll and Hugo static site generators, and many documentation platforms. They are NOT supported in basic Markdown (CommonMark) — table support requires GitHub Flavored Markdown (GFM) or MultiMarkdown.