Word to Confluence Markdown: チームウィキにドキュメントをインポートする

Confluence は最も広く使用されているチームウィキの一つで,多くの組織には Word ドキュメントのライブラリが Confluence に属しています. Confluenceの Markdown サポートには特異点があります. このガイドは,最も信頼性の高い Word に Confluence ワークフロー

Confluence は Markdown をサポートしていますか?

Confluenceには Markdown の部分的なサポートがありますが,これは実装に依存しています.

Confluence 雲 Markdownマクロをサポートし,特定の文脈で Markdown をレンダリングできますが,ネイティブエディターは独自のフォーマットです.
Confluence データセンター / サーバー また Markdown マクロを持っています.
アトラシアン・ロボ / 新しい編集者 新しいバージョンでは Markdown 添付サポートが改善されています

すべてのバージョンで最も信頼性の高い方法は Word を Markdown に変換することです WordToMDMarkdownコンテンツを Confluences Markdownインポート機能で貼る.

メソッド1: Markdown を Confluence エディターで貼る

ステップ

Word ドキュメントを Word で変換する WordToMD そして Copy Markdownをクリックします.
Confluence で,ページエディタを開く
挿入メニュー (+ アイコン) からマークまたはその他のマクロ →マークを選択します
言語として Markdown を選択する
Markdown コンテンツを貼る
挿入をクリック

Markup/Markdownマクロは,ページ内のリッチテキストとしてコンテンツを表示します. Confluenceブロックに変換しないが,ヘッダや表,リストを正しく表示する.

メソッド2: Word ファイルインポート

Confluence クラウドには Word インポート機能があります:

新しい Confluence ページを作成する
... メニュー → Word ドキュメントのインポートをクリック
.docx ファイルを選択する

複雑なフォーマットが失われる傾向があります. マークダウンの経路はより多くのコントロールを与える.

方法3: HTML に変換する

Confluenceのエディタが HTMLペーストを受け入れるため,一部のチームは HTML を中間フォーマットとして好む.

Word doc を Markdown に変換する WordToMD
Markdown を HTML にオンラインツールで変換する marked library
Confluence ソースエディターに切り替える (Ctrl+Shift+Dまたはツールバーから)
挿入する.

このアプローチは,より複雑なフォーマットを維持しますが,より多くのステップです.

フォーマット互換性

エレメント	Markdown	Confluence レンダリング
項目H1-H6	✅	✅ 正確に表現する
ボールド / イタリック	✅	✅ 正確に表現する
チェックリスト	✅	✅ 正確に表現する
番号付きリスト	✅	✅ 正確に表現する
テーブル	✅	✅ Markdown マクロ経由
コードブロック	✅	✅ Markdown マクロ経由
ハイパーリンク	✅	✅ 正確に表現する
画像	️ 外部のURLのみ	️ インラインの添付ファイルは手動でアップロードする必要があります

取扱用テーブル

Word テーブルを GFM パイプ構文に変換する WordToMD. Confluence’s Markdown macro renders these correctly:

| Project | Owner | Status |
|---|---|---|
| Website redesign | Alice | In progress |
| API migration | Bob | Complete |

より複雑なテーブル操作については, Markdown 表: 完全なガイド.

Confluence のコードブロック

Confluenceには独自のコードブロックマクロがあり,構文ハイライトと行番号を提供しています. Markdown コンテンツをインポートした後より読みやすいように,マークダウンマクロのコードブロックをネイティブのコンフルーエンスコードブロックマクロに置き換える必要があります.

ページを編集する
コードセクションを検索する
コードブロックマクロを挿入
構文をハイライトする言語を設定する
コードを貼る

参照: Markdown コードブロックガイド標準的な文法です

アトラシアン Confluence と ADF

Confluence クラウドでネイティブに使用される アトラシア文書フォーマット (ADF) 豊かなコンテンツのための JSON スキマこのマクロの上に位置しています. プログラムによる輸入の場合, Confluence REST API は ADF を直接受け入れます. 自動パイプラインを作っている場合は,利用可能なライブラリを使用して Word → Markdown → ADF を変換します.

ほとんどのチームでは手動の作業が簡単で速いのです

ドキュメントライブラリを移行する

Word のドキュメントを Confluence に移行している場合:

すべてのファイルを変換する WordToMD (または Pandoc 大量の場合)
Confluence スペースを作成し,ページの階層を計画する
ページをセクションにインポートし,関連文書を親ページにグループ化
Confluence 特定の特徴を輸入後追加する:ラベル,ページ制限, @mentions

FAQ

マクロなしで Markdown を Confluence でネイティブに使うことはできますか? 自動変換 (e.g.,入力) を実行します. ## H2を生成する. しかし,変換されたドキュメントを貼る場合は Markdown マクロがより信頼性があります.

輸入後,すべてボディテキストのように見える. これは通常 Markdown マクロがアクティブではないことを意味します. Markdownは,標準編集に素文字として貼り付けられていない,マークアップ/Markdownマクロブロック内になければならない.

テーブルは原始パイプ文字として表示されています. 同じ問題です内容は Markdown マクロ内ではなく標準テキストエディター内にある必要があります

Word ドキュメントを Confluence ページに同期する自動化方法はあるか? そうです Confluence のようなツール外部ドキュメント機能スクロールバージョン Confluence REST API を使用するカスタムスクリプトは Markdown ファイルをページに自動的に同期できます.

結論

最も清潔な Word に Confluence ワークフローは: WordToMD,その後 Markdown マクロを介してインポートします. 複雑な文書や大量移行の場合, HTML インターミディアットアプローチまたは REST API オートメーションにより多くの制御が可能になります. いずれにしても,変換前に Wordのヘッディングスタイルを正しく使用すると,ページの階層が無傷になるようにします.