Markdown Table to Confluence
Convert a Markdown table for Confluence: paste-ready rich table for the Cloud editor, wiki markup for Data Center, or storage-format XHTML.
Sample shown — paste your own Markdown to replace it.
Confluence Cloud
- Click Copy as rich table.
- Open the page in edit mode and click where the table goes.
- Press Ctrl+V (⌘+V). The editor turns it into a native table you can resize and sort.
How to convert a Markdown table to Confluence in 3 steps
Paste your Markdown
Paste one table or a whole page of Markdown. Every GitHub-style table is found, and CSV or tab-separated cells work too.
Choose your Confluence
Cloud editor copies a rich table that Confluence Cloud turns into a native table. Wiki markup is for Data Center and Server (Insert → Markup). Storage format is for the REST API.
Copy and paste
Click the copy button, open the page in edit mode, and paste with Ctrl+V (⌘V), or paste the markup into the Markup dialog.
Example
| Service | Owner | Runbook | Status |
| :--- | :--- | :--- | :---: |
| `api-gateway` | Platform | [Runbook](https://example.com/rb/api) | **Healthy** |
| `search {v2}` | Discovery | — | ~~Retired~~ |
| auth | Identity | a \| b | Healthy<br>(failover tested) ||| Service || Owner || Runbook || Status ||
| {{api-gateway}} | Platform | [Runbook|https://example.com/rb/api] | *Healthy* |
| {{search \{v2\}}} | Discovery | — | -Retired- |
| auth | Identity | a \| b | Healthy \\ (failover tested) |Options explained
- Table
- Appears when the input holds more than one table. "All tables" outputs every table, one after another; pick one to convert only that table.All tables (default) · any single table
- Cloud editor
- Copy as rich table puts an HTML table and plain text on the clipboard. The Confluence Cloud editor converts a pasted HTML table into its own table, keeping bold, links and code.
- Wiki markup
- Confluence wiki markup: ||Header|| for the header row and |cell| for the rest. Use it in Confluence Data Center or Server through Insert → Markup, or in any editor that still has a wiki-markup mode.
- Convert bold, code & links
- Wiki markup tab only. On: **bold** becomes *bold*, *italic* becomes _italic_, `code` becomes {{code}}, ~~strike~~ becomes -strike- and [text](url) becomes [text|url]. Off: every cell is plain, escaped text.On (default) · Off
- Storage format
- XHTML table in Confluence storage format, for the REST API (body.storage.value) and storage-format source editors. Cells are wrapped in paragraphs, as Confluence writes them.
Convert to and from other formats
Convert Markdown to…
- Markdown Table to CSVExport a Markdown table as RFC 4180 CSV.
- Markdown Table to TSVCopy as tab-separated values that paste cleanly into Excel and Sheets.
- Markdown Table to HTMLExport semantic <table> markup.
- Markdown Table to JSONExport rows as an array of JSON objects.
- Markdown Table to LaTeXExport LaTeX tabular code for papers and Overleaf.
- Markdown Table to SQLGenerate CREATE TABLE and INSERT statements.
- Markdown Table to ExcelDownload a real .xlsx with numbers, bold header and one sheet per table.
- Markdown Table to Google SheetsCopy a table that pastes cleanly into Google Sheets.
- Markdown Table to WordCopy a formatted table into Word or Google Docs, or download .docx.
- Markdown Table to JiraConvert to Jira and Confluence wiki markup.
- Markdown Table to ImageRender the table as a PNG or SVG for slides and posts.
Convert to Markdown from…
- CSV to Markdown TableConvert CSV text or .csv files, including quoted cells.
- Excel to Markdown TablePaste cells copied from Excel straight into a Markdown table.
- Google Sheets to Markdown TablePaste a copied range or a public sheet URL.
- TSV to Markdown TableConvert tab-separated text into a Markdown table.
- HTML Table to MarkdownConvert <table> markup into a Markdown table.
- JSON to Markdown TableConvert a JSON array of objects into a table.
- SQL to Markdown TableConvert MySQL, PostgreSQL or SQLite CLI query output.
- Word Table to MarkdownPaste a table copied from Word or Google Docs.
- Web Table to MarkdownCopy a table from any web page and paste it here.
- Image to Markdown TableTurn a screenshot or photo of a table into Markdown in your browser.
- PDF to Markdown TableExtract a table from a PDF page, with OCR for scans.
- Universal Table to MarkdownPaste anything tabular; the format is detected for you.
About this tool
Confluence does not read Markdown pipe tables, and the two editors want different things. The Cloud editor converts a table pasted as rich text, so Copy as rich table is the quick route. Data Center and Server take Confluence wiki markup (||Header|| and |cell|) through Insert → Markup, with pipes and braces escaped so cells and macros do not break. The REST API takes storage-format XHTML. This page produces all three from one Markdown table, in your browser. For Jira tickets and comments, use the Markdown Table to Jira page instead.
- Three outputs: Cloud paste, wiki markup and storage format
- Pipes, braces and brackets escaped so macros do not fire
- Bold, italic, code, strike, links and images translated
- <br> line breaks become wiki \\ line breaks inside the cell
- Several tables from one Markdown document
- Header row becomes a real Confluence header row
- Clear paste steps for Cloud and Data Center
- Runs in your browser; the table is not sent anywhere
Technical details
Confluence table syntax and what is escaped
Confluence has its own table markup rather than Markdown pipes: a header row is written ||Header 1||Header 2|| and each body row |cell|cell|. There is no delimiter row, and a row must stay on one line. The syntax is the same one Jira uses; the Markdown Table to Jira page covers Jira fields and comments.
- Escaping: | { } [ ] are always backslash-escaped in plain text, because | ends a cell and { starts a macro such as {code} or {info}. Markers such as * _ - + ^ ~ are escaped when they could pair up into formatting.
- Inline formatting: bold is *text*, italic is _text_, monospace is {{text}}, strikethrough is -text-, superscript is ^text^, subscript is ~text~, links are [text|url] and images are !url!.
- Line breaks: a cell cannot contain a newline, so <br> and line breaks are written as \\ (two backslashes).
- Alignment: wiki markup has no column alignment, so :---: and ---: from the Markdown delimiter row are not carried over. The Cloud editor tab writes alignment into the pasted HTML, and the storage format carries it as text-align on the paragraph.
- Storage format: Confluence stores a page as XHTML. The table is written as table, tbody, tr, th and td elements with each cell wrapped in a paragraph, and images as ac:image elements.
Common problems and fixes
The wiki markup shows up as text in Confluence Cloud
Cause: The current Cloud editor does not convert wiki markup typed or pasted into the page body.
Fix: Use the Cloud editor tab (Copy as rich table) and paste into the page. If your site offers Insert → Markup, the wiki markup can also go there.
The table pasted as plain text in Cloud
Cause: The browser only allowed plain text on the clipboard, or you pasted into a field that takes text only, such as a macro body.
Fix: Paste into the normal page body. If the copy button reports an error, select the preview table and copy it with Ctrl+C.
A macro or an error appears inside a cell
Cause: An unescaped { starts a Confluence macro such as {code} or {panel}.
Fix: Use this converter: it writes \{ and \} so the braces stay literal.
Cells shifted or a row broke apart
Cause: A | inside a cell was read as a cell separator, or the cell contained a real line break.
Fix: Convert with this tool, which writes \| and turns line breaks into \\.
The Markup dialog is missing
Cause: The Markup option is in the Data Center and Server editor. Some Cloud sites do not show it.
Fix: In Cloud, use the Cloud editor tab and paste the rich table.
Platform compatibility
| Platform | Support | Notes |
|---|---|---|
| Confluence Cloud (current editor) | Supported | Copy as rich table, then paste into the page body. The editor converts the HTML table to a native table. Wiki markup typed into the body is not converted. |
| Confluence Data Center and Server | Supported | Open Insert more content (+) → Markup, choose Confluence Wiki, paste the wiki markup and click Insert. Pasting a rich table into the editor usually works as well. |
| Editors with a wiki-markup mode | Supported | Older Confluence editors and wiki-renderer fields accept the wiki markup directly. |
| Confluence REST API | Supported | Use the Storage format tab and send the XHTML as body.storage.value with representation storage. |
| Jira | Supported | Jira Server, Data Center and legacy wiki-renderer fields use the same || and | table syntax. See the Markdown Table to Jira page for Jira-specific notes. |
Frequently asked questions
How do I convert a Markdown table to a Confluence table?
Paste the Markdown into the box on this page. For Confluence Cloud click Copy as rich table and paste into the page; for Data Center or Server copy the wiki markup and insert it through Insert → Markup with Confluence Wiki selected.
How do I paste a table into Confluence Cloud?
Use the Cloud editor tab, click Copy as rich table, open the page in edit mode, click where the table goes and press Ctrl+V (⌘V on a Mac). The editor converts the HTML into a native table you can resize and edit.
What is the Confluence wiki markup for a table?
A header row is written ||Header 1||Header 2|| and each body row |Cell 1|Cell 2|. There is no delimiter row, and every row stays on one line. Line breaks inside a cell are written \\.
How do I insert wiki markup in Confluence?
In Confluence Data Center and Server, choose Insert more content (+) → Markup, pick Confluence Wiki, paste the markup, check the preview and click Insert. As of October 2026 the current Cloud editor does not convert wiki markup in the page body, so use the Cloud editor tab there.
Does Confluence support Markdown tables?
Confluence tables are written in wiki markup or edited in the editor, not with Markdown pipes. A Markdown pipe table pasted into the Cloud editor may stay as plain text, so converting it first is the reliable route.
How do I put | or { inside a Confluence table cell?
Escape them with a backslash: \| and \{. An unescaped | ends the cell and an unescaped { starts a macro. This converter escapes them for you.
How are line breaks inside a cell handled?
Wiki markup uses two backslashes (\\) for a line break inside a cell, and the converter turns <br> into it. In the Cloud editor tab the break stays a real line break in the pasted table.
Is this the same as the Markdown to Jira converter?
The table syntax is the same, but this page is built for Confluence: a Cloud paste, a Data Center Markup insert and storage format. Use the Markdown Table to Jira page for ticket descriptions and comments.
What is the storage format output for?
It is the XHTML Confluence stores a page as. You need it for the REST API (body.storage.value) or when editing a page in a storage-format source editor.
Is my table uploaded anywhere?
No. The Markdown is parsed and converted in your browser, and the clipboard text is created locally.