こんにちは。アジャイルコーチの視点から、皆さんのチームの「知の流動性」を最大化するお手伝いをします。
「過去の資産をConfluenceに移したいけれど、レイアウトが崩れて絶望した」「Wordのコピペで数時間を溶かした」……そんな経験はありませんか？
ドキュメントがConfluenceに統合されていない状態は、いわば「脳の記憶が別々の部屋に散らばっている」のと同じです。情報のサイロ化は、チームのベロシティを確実に殺します。
今日は、Confluenceのインポート機能を限界まで使い倒し、ドキュメント移行を「苦行」から「自動化された資産構築」へと変える極意を授けましょう。
—
1. なぜ「そのまま」インポートしてはいけないのか？
WordやMarkdownをそのまま放り込むと、Confluenceの「ページ属性」と衝突して崩壊します。
- Wordの課題: 独自のスタイルや余白設定がConfluenceの「マクロ」と喧嘩します。
- Markdownの課題: 画像のパス（ローカル参照）が解決できず、リンク切れを起こします。
これを防ぐための鉄則は、「ソース側で構造を単一化すること」です。
—
2. レイアウト崩れを防ぐ「事前フォーマット整形術」
移行作業を始める前に、以下の「下準備」を徹底してください。これだけで成功率は8割上がります。
Wordから移行する場合の鉄則
1. 「見出し1〜3」以外を全削除: 本文は「標準」スタイルに統一してください。装飾されたフォントは全てConfluenceのテーマ設定に委ねるべきです。
2. 表（Table）のクリーニング: Word特有の「ネストされた表」は必ず解除してください。複雑な表は、いっそCSV化してConfluenceの「CSVデータ」マクロで取り込むのが賢明です。
3. 画像は「インライン配置」へ: 「テキストの折り返し」で複雑な位置に配置された画像は、必ず「行内（インライン）」設定に変更してください。
Markdownから移行する場合の鉄則
1. 相対パスの排除: 画像は一度Confluenceのページに直接ドラッグ＆ドロップしてアップロードし、そのURLをマークダウン内に記述し直すスクリプトを通すのがベストです。
—
3. Confluence一括インポートの「裏技」：階層構造を維持する
単にファイルをアップロードするだけでは、フラットなページが乱立し、地獄の整理作業が待っています。これを防ぐのが「Wordの目次設定を活用した構造化」です。
1. Wordの「見出し1」をConfluenceの「ページ作成の区切り」として認識させるよう、Word側で明示的にアウトラインを構成します。
2. Confluenceの「インポート機能」を使う際、「見出しのレベルをページ階層として扱う」オプションを有効にしてください。これで、Wordの章立てがそのままConfluenceの親子ページとして自動生成されます。
—
4. 精度高い「HelloWorld」的動作確認のステップ
いきなり本番データを投げ込むのは危険です。まずは小さなテストから始めましょう。
手順:
1. サンドボックス作成: プロジェクトスペース内に「Migration_Test」というページを作成。
2. サンプルテスト: 3ページ程度の短いWordファイルをインポート。
3. マクロの確認: `Table of Contents` マクロを挿入し、見出しが正しくリンクするかを確認。
4. 画像パスチェック: ブラウザの検証ツール（F12）を開き、画像URLが `confluence.your-domain.com/download/attachments/…` になっているか確認。
Markdownの画像をConfluence形式に置換する簡易スクリプト（ヒント）
複雑なリンクを正規表現で一括変換すると捗ります
sed -i ‘s/!\[.\](\(.\))/!\1!/g’ document.md
この後にConfluenceのMarkdown記法サポートを有効にして貼り付けます
—
5. 最後に：ドキュメントは「生き物」である
ここが最も重要な視点です。「完璧な移行」を目指してはいけません。
Confluenceにデータを移すのはゴールではなく、「ここからチームで育てていく」ためのスタートラインです。インポートした直後のドキュメントは、あくまで「下書き」として扱い、チームメンバーがコメントやタスク機能で改善し始めた瞬間、そのドキュメントには魂が宿ります。
これをマスターすれば、毎日の作業が劇的に楽になります。過去の呪縛から解放され、チームが「未来の価値創造」に集中できる環境を、あなたの手で作り上げてください。
応援しています。何か具体的なエラーや、大規模移行の設計で詰まったら、いつでも相談してくださいね。