MarkdownCo

Markdown to Confluence 轉換器

貼上或上傳 Markdown,即可取得能直接用於 Data Center、Server 或 Jira 的 Confluence Wiki Markup。標題、表格、程式碼區塊與連結都會轉換為對應的 Wiki Markup 寫法,LaTeX 公式原樣保留,不做任何改動。

輸出 Wiki Markup含語言標籤的程式碼巨集保留 LaTeX 公式
document.md
confluence.txt

Confluence Wiki Markup

輸出內容會隨輸入即時更新。點擊「轉換並下載」即可儲存為檔案。

如何將 Markdown 轉換為 Confluence

只要三個步驟,就能從 .md 檔案取得可直接用於 Confluence 的 Wiki Markup。

1

加入 Markdown 內容

將 Markdown 貼到編輯器中,或拖曳一個 .md 檔案進來。

2

確認 Wiki Markup

右側面板會隨輸入即時顯示 Confluence Wiki Markup。匯出前請先確認程式碼巨集與表格是否正確。

3

轉換並下載

點擊「轉換並下載」可將 Wiki Markup 儲存為 .txt 檔案,並保留在轉換歷史中。

Confluence Wiki Markup 的適用場景

Confluence Wiki Markup 是 Confluence Data Center、Server 與 Jira 原生解析的文字格式。用 Markdown 撰寫、於匯出時再轉換,能讓原始檔案繼續留在 git 管理,同時團隊在 Confluence 上正常閱讀。

Confluence Data Center and Server pages
透過 Insert > Markup 貼到 Confluence Data Center 與 Server 頁面
Jira descriptions and comments
Jira 的描述欄與留言,兩者使用相同的 Wiki Markup
Bulk migration into Confluence
將 README 與文件庫大量遷移到 Confluence
Runbooks and technical notes
發布以 Markdown 撰寫的維運手冊與技術筆記

Markdown 如何對應為 Confluence Wiki Markup

每個 Markdown 元素都會轉換為對應的 Wiki Markup 寫法,且此轉換已在包含大量程式碼與公式的實際技術文件上測試過。

程式碼區塊會轉換為程式碼巨集

圍籬式程式碼區塊會轉換為 {code:language=...} 巨集,並保留語言標籤,因此 Confluence 中的語法標色能正常顯示。

Code blocks become code macros

表格與連結轉換乾淨整齊

GFM 表格會對應為 ||header|| 表頭列與 |cell| 內容列;[text](url) 格式的連結會轉換為 [text|url]。巢狀清單會保留原本的層級深度。

Tables and links convert cleanly

LaTeX 公式原樣保留,不做任何改動

系統會偵測 $$ 區塊與行內 $...$ 公式並原樣保留,間距指令、矩陣換行符號與跳脫大括號都不會遺失,因此 Confluence 端的公式巨集可以正常渲染。

LaTeX math passes through untouched

標題、引用與分隔線一對一轉換

# 標題會轉換為 h1. 到 h6.,引用區塊會轉換為 {quote} 區塊,分隔線會轉換為 ----。文件結構會逐行完整保留。

Headings, quotes, and rules map 1:1

Markdown to Confluence 常見問題

以下解答涵蓋 Wiki Markup 輸出、程式碼巨集、公式處理,以及與 Confluence Cloud 的相容性。

如何將 Markdown 轉換為 Confluence Wiki Markup?

將 Markdown 貼到編輯器中,或上傳一個 .md 檔案。輸出面板會隨輸入即時顯示 Wiki Markup 預覽。要取得輸出內容,請點擊「轉換並下載」——轉換結果會以 .txt 檔案儲存到轉換歷史中。此操作需要登入並消耗點數,詳情請見定價頁面

這個工具輸出的是什麼格式?

Confluence Wiki Markup——也就是 Confluence Data Center、Server 與舊版編輯器所解析的文字語法(h1. 標題、*粗體*、{code} 巨集、||table|| 列)。這與 Jira 描述欄和留言中使用的是同一套標記系統。

輸出結果能在 Confluence Cloud 中使用嗎?

部分可以。Confluence Cloud 的新版編輯器已移除 Insert > Markup 選項,因此無法直接貼上 Wiki Markup。Wiki Markup 在 Data Center、Server、Cloud 舊版編輯器以及 Jira 中都能正常使用。如果你用的是 Cloud 新版編輯器,可以直接貼上 Markdown 內容——貼上時大多數語法會自動轉換。

程式碼區塊是如何轉換的?

圍籬式程式碼區塊會轉換為 {code:language=...} 巨集。起始圍籬後的語言識別碼(例如 ```python、```js)會被帶入巨集中,因此 Confluence 能套用正確的語法標色。沒有語言標籤的區塊會轉換為 {code:language=text}。

LaTeX 公式會怎麼處理?

公式會逐位元組原樣保留。轉換器會在轉換前偵測 $$ 區塊與行內 $...$ 公式,並在轉換後原樣還原,因此像 \, 這樣的間距指令與矩陣換行符號 \\ 都不會被破壞。Confluence 本身沒有內建公式渲染功能,需要在你的實例上搭配 LaTeX 公式巨集應用程式來顯示輸出結果。

支援 Markdown 表格嗎?

支援。GitHub 風格的 Markdown 表格會轉換為 Confluence 的表格語法:表頭列轉換為 ||header|| 儲存格,內容列轉換為 |cell| 列。由於 Wiki Markup 表格不支援欄位對齊語法,轉換時會將其移除。