ブログに戻る

Markdown を Confluence Wiki Markup に変換する方法

MD-TO チーム •
markdown confluence wiki-markup converter

Markdown でドキュメントを書いていても、チームが Atlassian Confluence を使っている場合、フォーマットの違いに悩まされることがあります。Confluence Data Center と Server は独自の wiki markup 構文を使用しており、Markdown とはまったく異なります。

手動で書き換えるのは面倒でミスも起きやすいです。md-to.com は無料のブラウザベース変換ツールを提供しており、Markdown を Confluence wiki markup にリアルタイムで変換できます。

この記事では、ツールが対応している構文、使い方、注意点を紹介します。

対応している構文

変換器は以下の Markdown 要素を処理し、対応する Confluence 形式にマッピングします。

テキストフォーマット

MarkdownConfluence 出力
**太字***太字*
*斜体*_斜体_
~~取り消し線~~-取り消し線-
`インラインコード`{{インラインコード}}

見出し

Markdown の # から ###### は、Confluence の h1. から h6. に対応します。

## セクションタイトル

は以下に変換されます：

h2. セクションタイトル

リンクと画像

  • [Google](https://google.com) は [Google|https://google.com] に変換
  • ![代替テキスト](https://example.com/img.png) は !https://example.com/img.png|alt=代替テキスト! に変換

コードブロック

フェンスコードブロックは Confluence の {code} マクロに変換されます。言語識別子は保持されます：

```javascript
function greet(name) {
  return "Hello, " + name;
}
```

は以下に変換されます：

{code:language=javascript}
function greet(name) {
  return "Hello, " + name;
}
{code}

言語タグのないコードブロックは :language= 属性を省略します。

テーブル

Markdown テーブルは、ヘッダーセルに ||、データセルに | を使って変換されます：

| 名前 | 年齢 |
|------|------|
| 太郎 | 30   |

は以下に変換されます：

||名前||年齢||
|太郎|30|

セル内のパイプ文字は自動的にエスケープされます。

リスト

  • 箇条書きリストは * を使用し、ネストには **、さらに深い階層には *** を使用します。
  • 番号付きリストは # を使用し、ネストには ## を使用します。
  • タスクリストも変換されます：- [x] は (/)（完了）に、- [ ] は (x)（未完了）になります。

引用ブロック

引用ブロックは {quote}...{quote} で囲まれます。ネストされた引用は単一の {quote} ブロックにフラット化されます。Confluence はネストされた引用をサポートしていないためです。

水平線

Markdown の --- は Confluence の ---- に変換されます。

使い方

  1. md-to.com/ja/markdown-to-confluence の左側エディタに Markdown を貼り付け ます。
  2. 出力を確認 — 右側パネルが入力に合わせてリアルタイムで更新されます。
  3. 出力パネル上部のボタンで コピーまたはダウンロード します。

エディタは入力と出力のスクロールを同期するので、長いドキュメントでも対応箇所を見失うことなく確認できます。

仕組み

変換器は markdown-it をベースに構築されています。markdown-it は Markdown パーサーで、入力をトークンストリーム（抽象構文木）に解析します。脆弱な正規表現置換を使う代わりに、ツールはトークンツリーを走査し、各ノードを対応する Confluence markup にレンダリングします。

このアプローチにより：

  • ネストされた構造（リスト内のリスト、リスト項目内のコードブロック）が正しく処理されます。
  • リンク、画像、テーブルセル内の特殊文字が必要に応じてエスケープされます。
  • 出力が markdown-it の入力解釈と一致し、エッジケースの予期しない動作を回避できます。

すべての処理はブラウザ内でローカルに行われます。データはサーバーに送信されません。

対応環境と制限事項

対象環境： 出力は Confluence Data Center / Server、または Confluence Cloud のレガシーマークアップ挿入フローを対象としています。Confluence Cloud の新エディタは wiki markup の直接貼り付けをサポートしていません。

既知の制限：

  • ネストされた引用ブロックはフラット化されます — Confluence wiki markup はネストされた {quote} をサポートしていません。
  • Markdown 内の生の HTML は無視されます（パーサーで HTML が無効化されています）。
  • 高度な markdown-it プラグイン（脚注、定義リストなど）は有効化されていません。

まとめ

Markdown コンテンツを Confluence Data Center や Server に移行する必要がある場合、この変換器が構文マッピングを処理します — 見出し、書式、コードブロック、テーブル、リストなど。

こちらから試せます：md-to.com/ja/markdown-to-confluence

リソース：

関連ツール

無料 Markdown から Confluence Wiki Markup コンバーター

Markdown を Confluence wiki markup に無料で変換。Confluence Data Center、Server、旧マークアップフローに適しています。登録不要！