How do table headers work in Confluence wiki markup?

Header cells use double pipes: ||Name||Role|| renders as a header row. Body rows use single pipes: |Alice|Engineer|. There is no separate separator row like Markdown's |---|.

Why did my Markdown table collapse when pasted into Confluence?

Confluence does not parse Markdown pipes on paste, so the table arrives as plain text. Converting to wiki markup first and pasting through Insert > Markup preserves the structure.

Can Confluence tables have column alignment like Markdown?

Not through wiki markup — Markdown's :--- alignment syntax has no wiki markup equivalent. Alignment is applied in the Confluence editor after inserting the table.

What is the fastest way to get a spreadsheet into Confluence?

Export it as CSV, convert CSV to a Markdown table, then convert that to Confluence wiki markup — or paste the CSV into the CSV-to-Markdown tool and run the result through the Confluence converter.

Confluence wiki markup guide

Markdown Table to Confluence

Convert Markdown pipe tables into Confluence wiki markup tables with proper header rows, and avoid the collapses that happen when you paste tables directly.

Direct answer

A Markdown table converts to Confluence wiki markup by turning the header row into double-pipe cells (||Header||) and each body row into single-pipe cells (|cell|). The Markdown separator row (|---|) is dropped entirely — Confluence marks headers with the double pipes instead.

Jira issues use the same ||header|| table syntax, so the Markdown to Jira converter gives you the same table for a ticket description.

Open Markdown to Confluence converter

When to use this

A Markdown table pasted into Confluence collapsed into one line of pipes and dashes.
Status reports, comparison matrices, or data tables authored in Markdown need to live in Confluence.
A CSV or spreadsheet export was converted to a Markdown table and Confluence is the destination.

Steps

Make sure every Markdown row has the same number of pipe-separated cells.
Convert the table — the header row becomes ||...|| cells and the |---| separator row disappears.
Paste the result through Insert > Markup with 'Confluence wiki' selected.
Check the preview: each || cell renders as a shaded header cell.
Fix any row that renders as plain text — it almost always has a missing or extra pipe.

Example conversion

Markdown input

| Service | Owner | Status |
|---------|-------|--------|
| API | Platform | Live |
| Billing | Payments | Beta |

Confluence wiki output

||Service||Owner||Status||
|API|Platform|Live|
|Billing|Payments|Beta|

Common mistakes

Do not keep the Markdown |---| separator row — Confluence renders it as a literal row of dashes.
Do not leave empty cells truly empty in wiki markup; use a space between pipes so the row keeps its shape.
Do not use pipe characters inside cell text without escaping — they split the cell.

FAQ

How do table headers work in Confluence wiki markup?: Header cells use double pipes: ||Name||Role|| renders as a header row. Body rows use single pipes: |Alice|Engineer|. There is no separate separator row like Markdown's |---|.
Why did my Markdown table collapse when pasted into Confluence?: Confluence does not parse Markdown pipes on paste, so the table arrives as plain text. Converting to wiki markup first and pasting through Insert > Markup preserves the structure.
Can Confluence tables have column alignment like Markdown?: Not through wiki markup — Markdown's :--- alignment syntax has no wiki markup equivalent. Alignment is applied in the Confluence editor after inserting the table.
What is the fastest way to get a spreadsheet into Confluence?: Export it as CSV, convert CSV to a Markdown table, then convert that to Confluence wiki markup — or paste the CSV into the CSV-to-Markdown tool and run the result through the Confluence converter.

Related Confluence guides

Markdown Runbook to Confluence

Convert a Markdown runbook into Confluence wiki markup with steps, warnings, code blocks, and rollback notes.

Confluence Technical Spec Template

Format a Markdown technical spec for Confluence with problem, decision, architecture, tradeoffs, and open questions.

Markdown Incident Review to Confluence

Convert a Markdown incident review into a Confluence page with timeline, impact, root cause, and follow-up actions.

Markdown Meeting Notes to Confluence

Turn Markdown meeting notes into a Confluence page with decisions, action items, blockers, and links.

Paste Markdown into Confluence (Without Broken Formatting)

Convert the Markdown to Confluence wiki markup, then paste it through Insert > Markup. That is the only way headings, tables, and code blocks survive. Raw Markdown pastes as plain text.

Markdown Code Blocks to Confluence

Turn Markdown fenced code blocks into Confluence {code} macros with syntax highlighting, and know when to use {noformat} instead.

Markdown Checklists to Confluence

Convert Markdown task lists (- [ ] and - [x]) into Confluence-friendly checklists using (/) and (x) status icons, or the editor's action items.

Reading for wiki and docs work

How to structure a Confluence space, and how to write the pages that go in it.

Book · Confluence

Implementing Atlassian Confluence

How to set up Confluence for a distributed team: space structure, page templates, and permissions that hold up as the wiki grows.

Space and page structure
Templates and permissions
Distributed team collaboration
Pairs with the Markdown to Confluence tool

Check price on Amazon →Book · Docs

Handbook of Technical Writing (10th ed.)

The desk reference for technical documentation. You look entries up mid-draft instead of reading it front to back.

Alphabetical reference format
Usage, grammar, and document types
Tenth edition
For docs, specs, and release notes

Check price on Amazon →Book · Docs

Technical Writing Process

A five-step method for user guides, manuals, and procedures. It is written for people who write docs without a docs job title.

Five-step process
User guides, manuals, procedures
Plan, structure, draft, review, publish
No prior technical-writing training assumed

Check price on Amazon →

Amazon affiliate links. We earn a commission on qualifying purchases at no extra cost to you.