← ブログに戻る

ConfluenceページをMarkdownにエクスポートする方法（2026年完全ガイド）

· Save Team
#confluence#markdown#documentation#enterprise#migration

Confluenceはあなたを引き留めようとする。Atlassianはコンテンツを独自のXML形式で保存し、Markdownエクスポートは提供せず、一括抽出は面倒だ。Confluenceからクリーンなテキストを取り出そうとしたことがあれば、そのフラストレーションはよくわかるだろう。

このガイドでは、ConfluenceページをMarkdownにエクスポートするすべての方法を説明する --- 単一ページから全スペースまで。

なぜConfluenceをMarkdownにエクスポートするのか？

チームがConfluenceを離れる理由は様々だ：

  • 新しいツールへの移行 --- Notion、GitBook、Docusaurus、またはMarkdownを使う静的サイトジェネレーターへの移行
  • ナレッジベースのアーカイブ --- Atlassianのライセンスが切れる前にチームのドキュメントを保存
  • AIナレッジベースの構築 --- Claude、ChatGPT、または社内LLMにクリーンなドキュメントを提供
  • 重要なドキュメントのバックアップ --- Atlassianのサーバーに依存しないポータブルなコピーを保持
  • ベンダーロックインからの脱出 --- コンテンツを普遍的な形式で所有する

方法1：Save（単一ページに最速）

Saveは、任意のConfluenceページをワンクリックでクリーンなMarkdownに変換するChrome拡張機能だ。

使い方：

  1. ChromeでConfluenceページを開く
  2. Save拡張機能のアイコンをクリック
  3. .mdファイルが即座にダウンロードされる

取得できるもの：

  • 見出し階層を保持した完全なページテキスト
  • Markdownテーブルとしてフォーマットされたテーブル
  • 言語タグ付きのコードブロック
  • ブロック引用に変換された情報パネル
  • 展開/折りたたみセクション（完全に展開された状態）
  • クリーンなメタデータ：ページタイトル、スペース名、最終更新日
  • 内部・外部リンクの保持

削除されるもの：

  • AtlassianマクロおよびAtlassian独自のフォーマット
  • ナビゲーション、サイドバー、メニュー
  • WYSIWYGエディタのアーティファクト
  • インラインスタイルとCSS

最適な用途： 個別ページや少量のバッチを保存する場合。5〜50ページなら、これが最速の方法だ。

出力例

典型的なConfluenceのランブックから：

# Deployment Runbook --- Production API

**Space:** Engineering
**Last updated:** March 12, 2026

---

## Pre-Deployment Checklist

- [ ] All CI checks passing on `main`
- [ ] Database migrations reviewed and approved
- [ ] Feature flags configured for gradual rollout
- [ ] Rollback plan documented

## Deployment Steps

### 1. Create Release Branch

\`\`\`bash
git checkout -b release/v2.4.0 main
git push origin release/v2.4.0
\`\`\`

### 2. Run Database Migrations

\`\`\`sql
ALTER TABLE users ADD COLUMN preferences JSONB DEFAULT '{}';
CREATE INDEX idx_users_preferences ON users USING GIN (preferences);
\`\`\`

方法2：Confluenceの組み込みエクスポート（HTMLから変換）

ConfluenceはページをHTMLとしてエクスポートできる。その後、PandocなどのツールでHTMLをMarkdownに変換できる。

手順：

  1. ページ → … メニュー → PDF/Word/HTMLにエクスポートに移動
  2. HTMLエクスポートを選択
  3. Pandocで変換：pandoc input.html -o output.md

この方法の問題点：

  • HTMLエクスポートにはAtlassianのCSS、マクロ、インラインスタイルが含まれる
  • 変換中にテーブルが壊れることが多い
  • コードブロックから言語タグが失われる
  • 画像がConfluenceのURLを参照するため、後でリンク切れになる可能性がある
  • ネストされたページはスペース全体をエクスポートする必要がある

この方法は機能するが、手動でクリーンアップが必要な雑然とした出力になる。

方法3：スペースエクスポート＋一括変換

Confluenceスペース全体をエクスポートする場合：

  1. スペース設定 → コンテンツツール → エクスポートに移動
  2. HTMLフォーマットを選択
  3. ZIPアーカイブをダウンロード
  4. スクリプトを使ってHTMLファイルをMarkdownに一括変換する

問題点： Confluenceスペースのエクスポートは、リンク切れの相対リンク、重複したナビゲーション要素、Atlassian固有のマークアップを含む深くネストされたHTMLを生成する。これをプログラム的にクリーンアップするのは週末プロジェクト規模の作業だ。

方法4：Confluence REST API

プログラムによるアクセスのために：

curl -u [email protected]:API_TOKEN \
  "https://your-domain.atlassian.net/wiki/rest/api/content/PAGE_ID?expand=body.storage" \
  | jq -r '.body.storage.value' > page.html

これでストレージ形式（XHTML風）が得られる。以下の作業が必要になる：

  1. Atlassianのストレージ形式を解析する
  2. マクロ、埋め込み、特殊要素を処理する
  3. Markdownに変換する
  4. すべてのページに対して繰り返す

最適な用途： 移行パイプラインを構築するエンジニアリングチーム。ほとんどのユースケースには過剰だ。

どの方法を使うべきか？

シナリオ最適な方法
1〜50ページを素早く保存するSave拡張機能 --- ページごとにワンクリック
スペース全体をアーカイブするスペースエクスポート＋Pandoc --- 一括だが雑然とする
移行パイプラインを構築するREST API --- プログラム的だが複雑
重要なドキュメントをすぐにバックアップSave拡張機能 --- 最もクリーンな出力
ドキュメントをLLMに提供するSave拡張機能 --- MarkdownはLLMネイティブ

ほとんどの人にとって、Saveが答えだ。ゼロセットアップで最もクリーンなMarkdownを生成し、Confluenceの独自フォーマットを自動的に処理する。

Confluenceコンテンツを活用する

ページをMarkdownにエクスポートしたら、以下のことができる：

  • grep、VS Code、またはObsidianですべてを検索する
  • ClaudeやChatGPTに提供して、ドキュメントについての即座の回答を得る
  • Gitでバージョン管理する --- コードのようにドキュメントの変更を追跡
  • 任意のツールにインポートする --- Notion、Obsidian、GitBook、Docusaurus、または静的サイトジェネレーター
  • 永遠に保持する --- Markdownファイルはプレーンテキストだ。50年後も読める

始めましょう

Saveをインストールして、今すぐConfluenceページで試してみよう。無料で始められ、数秒でクリーンなMarkdownが確認できる。

Confluenceからの脱出は辛くなくていい。Saveはワンクリックで任意のページをクリーンなMarkdownに変換する。