Method 1: Direct paste (simplest)

Copy your Markdown text and paste it directly into the Confluence page editor. Confluence Cloud auto-converts basic Markdown syntax including headings, bold, italic, lists, links, and code blocks.

This is the fastest method for simple documents. Confluence recognizes the most common Markdown patterns and converts them on paste. However, it works best with clean, simple Markdown — complex tables or deeply nested lists may not convert cleanly.

When to use direct paste

• Your document is under 500 words
• It has no tables or only simple tables
• It uses basic formatting (headings, bold, italic, lists, links)
• You need to paste quickly and can fix minor issues manually

Method 2: The /markdown slash command (most reliable)

Type /markdown in the page body, paste your Markdown into the panel, review the preview, and click Insert. This is the most reliable native method for complex Markdown.

The /markdown slash command is Confluence's dedicated Markdown import tool. It gives you a preview before inserting, so you can catch formatting issues before they end up in your page.

How to use it

1. In the Confluence page editor, type /markdown
2. Select "Markdown" from the dropdown
3. Paste your Markdown text into the panel
4. Review the preview to check tables, lists, and formatting
5. Click "Insert" to add the content to your page

Method 3: Free converter tool (best for complex docs)

For documents with many tables, nested lists, or mixed formatting, use a free online Markdown-to-Confluence converter. Paste your Markdown, check the live preview, fix any issues, then copy the rendered rich text into your page.

A dedicated converter tool is the best option for long or complex documents. It gives you a live preview of how your Markdown will render, lets you fix issues before pasting, and preserves table structure better than direct paste.

How it works

1. Open the Markdown to Confluence converter
2. Paste your Markdown into the left panel (or upload a .md file)
3. Check the live preview on the right
4. Fix any formatting issues (especially tables and nested lists)
5. Click "Copy" to copy the rendered rich text
6. Paste into your Confluence page

This method is especially useful for:

• Documents with multiple tables
• Long documents (1000+ words)
• Documents with mixed content (tables + code blocks + lists)
• Batch conversion of multiple files

What converts cleanly vs. what doesn't

Basic Markdown syntax (headings, bold, italic, lists, links, code blocks) converts cleanly with all three methods. Tables, complex nested lists, and mixed content work best with the /markdown command or a converter tool.

Converts cleanly with direct paste

• # Heading 1 through ###### Heading 6
• **bold** and *italic*
• - bullet lists and 1. numbered lists
• `inline code` and ``` code blocks ```
• > quotes
• [links](url)
• --- dividers

Needs /markdown command or converter

• Tables (especially with merged cells or complex alignment)
• Deeply nested lists (3+ levels)
• Mixed content (tables + code blocks + lists in the same document)
• Documents with custom HTML or special characters

Common issues and fixes

Tables render as plain text with pipes

This is the most common issue. It happens when the Markdown table syntax is incorrect. Check that:

• You have a separator row with dashes (|---|---|)
• Every row has the same number of columns
• There are no extra spaces or pipes at the start/end of rows

If the table still doesn't convert, use the /markdown command or a converter tool instead of direct paste.

Nested lists flatten to a single level

This happens when indentation is inconsistent. Use consistent indentation (2 or 4 spaces per level) and avoid mixing tabs and spaces. If the list still flattens, simplify the nesting or use headings instead.

Code blocks lose indentation

Make sure you're using triple backticks (```) for code blocks, not single backticks. Single backticks are for inline code only. For multi-line code, always use triple backticks.

Pasted content has extra line breaks

This usually happens when copying from PDFs or web pages with complex CSS. Use "Paste as plain text" (Cmd/Ctrl+Shift+V) and reformat manually, or use a converter tool to clean up the content first.

Best practices for reliable conversion

1. Start with clean Markdown — Use a text editor with Markdown preview to check your syntax before pasting
2. Test with your most complex content — If your document has tables, test the table conversion first before pasting the whole document
3. Use the right method for the job — Direct paste for simple docs, /markdown for tables, converter for complex docs
4. Review the preview before inserting — The /markdown command and converter tools both show a preview. Use it to catch issues before they end up in your page
5. Keep a Markdown source — Save your original Markdown file so you can re-convert if you need to update the page later

Need to convert a complex document?

Paste your Markdown into the free converter, check the live preview, and copy the formatted result into Confluence. No account or install needed.

Try the free converter →

方法 1：直接粘贴（最简单）

复制你的 Markdown 文本，直接粘贴到 Confluence 页面编辑器中。Confluence Cloud 会自动转换基本的 Markdown 语法，包括标题、加粗、斜体、列表、链接和代码块。

这是简单文档最快的方法。Confluence 能识别最常见的 Markdown 模式并在粘贴时转换。但它最适合干净、简单的 Markdown——复杂的表格或深度嵌套的列表可能转换不干净。

什么时候用直接粘贴

• 文档在 500 字以内
• 没有表格或只有简单表格
• 使用基本格式（标题、加粗、斜体、列表、链接）
• 需要快速粘贴，可以手工修正小问题

方法 2：/markdown 斜杠命令（最可靠）

在页面正文中输入 /markdown，把你的 Markdown 粘贴到面板中，检查预览，然后点击插入。这是最可靠的原生复杂 Markdown 导入方法。

/markdown 斜杠命令是 Confluence 的专用 Markdown 导入工具。它在插入前给你预览，这样你可以在内容进入页面之前发现排版问题。

如何使用

1. 在 Confluence 页面编辑器中，输入 /markdown
2. 从下拉菜单中选择"Markdown"
3. 把你的 Markdown 文本粘贴到面板中
4. 检查预览，确认表格、列表和格式
5. 点击"插入"把内容添加到页面

方法 3：免费转换工具（最适合复杂文档）

对于包含大量表格、嵌套列表或混合格式的文档，使用免费的在线 Markdown 转 Confluence 转换器。粘贴你的 Markdown，检查实时预览，修正任何问题，然后把渲染后的富文本复制到你的页面。

专用转换工具是长文档或复杂文档的最佳选择。它让你实时预览 Markdown 的渲染效果，在粘贴前修正问题，比直接粘贴更好地保留表格结构。

如何工作

1. 打开 Markdown 转 Confluence 转换器
2. 把你的 Markdown 粘贴到左侧面板（或上传 .md 文件）
3. 检查右侧的实时预览
4. 修正任何排版问题（尤其是表格和嵌套列表）
5. 点击"复制"复制渲染后的富文本
6. 粘贴到你的 Confluence 页面

这个方法特别适合：

• 包含多个表格的文档
• 长文档（1000+ 字）
• 混合内容的文档（表格 + 代码块 + 列表）
• 批量转换多个文件

什么能干净转换，什么不能

基本 Markdown 语法（标题、加粗、斜体、列表、链接、代码块）用所有三种方法都能干净转换。表格、复杂嵌套列表和混合内容最好用 /markdown 命令或转换工具。

直接粘贴能干净转换

• # 标题 1 到 ###### 标题 6
• **加粗** 和 *斜体*
• - 无序列表 和 1. 有序列表
• `行内代码` 和 ``` 代码块 ```
• > 引用
• [链接](url)
• --- 分隔线

需要 /markdown 命令或转换工具

• 表格（尤其是有合并单元格或复杂对齐的）
• 深度嵌套列表（3 层以上）
• 混合内容（同一文档中有表格 + 代码块 + 列表）
• 包含自定义 HTML 或特殊字符的文档

常见问题和解决方法

表格渲染成带竖线的纯文本

这是最常见的问题。发生在 Markdown 表格语法不正确时。检查：

• 是否有带横线的分隔行（|---|---|）
• 每一行的列数是否一致
• 行首或行尾是否有多余的空格或竖线

如果表格还是无法转换，用 /markdown 命令或转换工具代替直接粘贴。

嵌套列表压平成单层

这发生在缩进不一致时。使用一致的缩进（每层 2 或 4 个空格），避免混用 Tab 和空格。如果列表还是压平，简化嵌套或用标题代替。

代码块丢失缩进

确保你用的是三个反引号（```）表示代码块，而不是单个反引号。单个反引号只用于行内代码。多行代码一定要用三个反引号。

粘贴的内容有多余的换行

这通常发生在从 PDF 或复杂 CSS 网页复制内容时。用"粘贴为纯文本"（Cmd/Ctrl+Shift+V）然后手工重新排版，或先用转换工具清理内容。

可靠转换的最佳实践

1. 从干净的 Markdown 开始 — 用带 Markdown 预览的文本编辑器检查语法，再粘贴
2. 用最复杂的内容测试 — 如果文档有表格，先测试表格转换，再粘贴整个文档
3. 根据任务选择正确的方法 — 简单文档用直接粘贴，表格用 /markdown，复杂文档用转换工具
4. 插入前检查预览 — /markdown 命令和转换工具都显示预览。用它来发现问题，避免问题进入页面
5. 保留 Markdown 源文件 — 保存原始 Markdown 文件，这样以后需要更新页面时可以重新转换

需要转换复杂文档？

把你的 Markdown 粘贴到免费转换器中，检查实时预览，然后把排版好的结果复制到 Confluence。无需账号或安装。

试用免费转换器 →