Confluence Markdown Tables: Create, Format & Edit Guide
Confluence has a visual table editor, but it's slow for creating structured tables — you need to click to add rows and columns one at a time. If you write documentation in Markdown, you can create tables much faster with Markdown syntax.
This guide shows how to create, format, and edit tables in Confluence using Markdown.
The problem with Confluence's native table editor
Confluence's built-in table editor requires multiple clicks:
- Click the table button
- Select the number of rows and columns
- Click each cell to enter content
- Use the toolbar to format alignment
For developers and technical writers who already have data in Markdown format, this is tedious. You can't paste a Markdown table into the native editor — it won't render.
Solution: Enhanced Markdown for Confluence
Enhanced Markdown for Confluence adds full Markdown support including GitHub Flavored Markdown (GFM) tables.
Basic Markdown table syntax
| Feature | Supported | Notes |
|---------|-----------|-------|
| Headings | Yes | H1–H6 |
| Tables | Yes | GFM syntax |
| Code blocks | Yes | Fenced with ``` |
| Task lists | Yes | - [ ] and - [x] |
This renders as a formatted Confluence table with borders and padding.
Table alignment
Control column alignment using colons in the separator row:
| Left aligned | Center aligned | Right aligned |
|:-------------|:--------------:|--------------:|
| Left | Center | Right |
| Text | Text | Text |
:---= left aligned (default):---:= center aligned---:= right aligned
How to create a Markdown table in Confluence
- Install Enhanced Markdown for Confluence from the Marketplace (free for up to 10 users)
- Open a Confluence page in edit mode
- Type
/enhanced markdownand select the macro - Write your table in Markdown syntax
- Switch to WYSIWYG mode to see the rendered result
- Save the page
Copy tables from GitHub
You can paste any Markdown table directly from GitHub READMEs, pull requests, or issues into the Enhanced Markdown editor. It renders correctly without any modification.
This is especially useful for:
- API documentation — paste parameter tables from spec files
- Changelog tables — copy release notes from GitHub releases
- Comparison tables — migrate feature comparison tables from Markdown docs
- Decision records — paste pros/cons tables from architecture discussions
Markdown tables vs Confluence tables
| Feature | Native Table | Markdown Table |
|---|---|---|
| Creation speed | Slow (click-based) | Fast (type-based) |
| Copy from GitHub | No | Yes |
| Version control friendly | No | Yes (plain text) |
| Alignment control | Toolbar clicks | :--- syntax |
| Merge cells | Yes | No |
| Row/column span | Yes | No |
| Background colors | Yes | No |
Markdown tables are ideal for structured data where every row has the same columns. For complex layouts with merged cells, use the native Confluence table editor.
Markdown table tips
Keep columns narrow — wide tables are hard to read in raw Markdown. Use abbreviations or short headers.
Use alignment for numbers — right-align numeric columns for better readability:
| Metric | Q1 | Q2 | Q3 |
|--------|---:|---:|---:|
| Revenue | 120 | 145 | 178 |
| Users | 1,200 | 1,500 | 2,000 |
Link in tables — you can include links in table cells:
| App | Documentation |
|-----|---------------|
| Mermaid Plus | [Docs](/docs/Mermaid-Plus-for-Confluence/usage) |
| Code Blocks | [Docs](/docs/Modern-Code-Blocks-for-Confluence/user-docs) |