【対応表付き】ConfluenceでMarkdown記法は使える？自動変換・マクロ＆貼り付け崩れ対策

SHARE

社内のナレッジ蓄積やプロジェクト管理、仕様書・要件定義書の作成ツールとして、世界中のIT企業や開発チームで圧倒的なシェアを誇るAtlassian（アトラシアン）の Confluence（コンフルエンス） 。日々の業務でページを作成する中で、 「普段VS CodeやNotion、ChatGPTで使い慣れているMarkdown（マークダウン）記法でサクサクWikiを書きたい」「外部でまとめたMarkdownドキュメントをConfluenceにそのままコピーして活用したい」 と考えているエンジニアやプロジェクトマネージャーは非常に多いはずです。

しかし、いざConfluenceのエディタでMarkdownを入力したり、ChatGPTやGitHubからコピーしたMarkdownテキストを貼り付けたりした際に、 「表（テーブル）がバラバラに崩れてしまった」「リストのインデント階層が消えた」「記号がそのまま文字列として残って反映されない」 といったトラブルに直面し、ストレスを感じた経験はないでしょうか？

結論からお伝えすると、 Confluence Cloudの新エディタは「オートフォーマット（自動変換）」と「マークダウンマクロ」の2つの仕組みによってMarkdownを便利に活用できます 。ただし、Confluenceは純粋なMarkdownエディタとは設計思想が根本から異なり、 「入力時にリアルタイムでリッチテキスト（ADF形式）へと不可逆変換される」 という独自ルールを持っています。この特性を正しく理解していないと、外部テキストをコピペした際に意図しない表示崩れに悩まされることになります。

本記事では、 Confluenceで即座に自動変換されるMarkdown記法の一覧早見表 から、外部Markdownを1ミリも崩さずに貼り付ける実践手順、ChatGPTやNotionとの連携ノウハウ、よくあるトラブルの回避策、FAQまでを徹底網羅してわかりやすく解説します！

📌 本記事でわかること・要点まとめ

  • 【対応状況と仕組み】 Confluence Cloud新エディタの「オートフォーマット（自動変換）」の基本仕様
  • 【記法早見表】 見出し（#）、太字、リスト、タスク、引用、表の対応一覧
  • 【コピペ崩れ対策】 外部ドキュメントを完璧に再現する「マークダウンマクロ」と貼り付けテクニック
  • 【外部ツール連携】 ChatGPT・VS Code・NotionからConfluenceへ綺麗に流し込むコツ
  • 【コード共有】 コードブロックマクロによるシンタックスハイライトと行番号表示の活用法
  • 【トラブル解決】 表が崩れる原因と回避策、Markdownエクスポート・移行の注意点
  • 【FAQ・構造化データ】 元の記法への復元可否やData Center版との違い、エディタショートカット一覧

ConfluenceのMarkdown対応状況｜できること・できないこと

まず初めに押さえておきたいのが、 「Confluenceは純粋なMarkdownエディタではない」 という基本仕様です。ConfluenceにおけるMarkdownサポートの正確な位置づけと、できること・できないことの境界線を明確に整理しておきましょう。

Cloud新エディタの「オートフォーマット」機能の仕組み

現在Confluence Cloudで標準採用されている新しいファブリックエディタ（新エディタ）には、 「オートフォーマット（Autoformatting）」 と呼ばれるスマートな入力支援機能が搭載されています。

これは、ユーザーがエディタ上で # 見出し や - リスト 、 **太字** などの特定のMarkdown記号を入力してスペースキーやEnterキーを押した瞬間に、 Confluence側が記号を即座に認識し、対応するリッチテキスト装飾（見出しブロックや箇条書き要素）へと自動変換してくれる仕組み です。

キーボードから手を離して画面上部のツールバーをマウスでクリックする必要がないため、タイピングの思考を止めることなく美しいレイアウトを素早く組み立てられるのが大きなメリットです。

純粋なMarkdownエディタとの違い（一度リッチテキストに変換される点）

Obsidian、VS Code、Typoraなどの純粋なMarkdownエディタとConfluenceの新エディタには、ドキュメントの内部構造において決定的な違いがあります。

  • 純粋なMarkdownエディタ： データそのものがプレーンテキスト（.mdファイル）として保存され、画面表示時のみCSSやパーサーによって装飾レンダリングされます。いつでも元の ## 見出し や | 表 | などのMarkdown文字列を直接再編集できます。
  • Confluenceの新エディタ： 入力されたMarkdown記法はその場で 「リッチテキスト（Atlassian Document Format: ADF）」へと不可逆変換 されます。保存されるデータはMarkdownではなくリッチテキスト構造であり、一度変換された見出しや表から元のMarkdown記号を再編集することはできません。

この 「一度リッチテキストに変換される」 という性質があるため、外部から大量のMarkdownテキストをそのままエディタにペーストした際、パーサーが正しく処理できずに書式が崩れたり、単なるプレーンテキストとして貼り付けられてしまったりするトラブルが発生します。外部文書を綺麗に取り込むには、後述するマクロの活用などの適切な手順が不可欠です。

【早見表】Confluenceで即変換されるMarkdown記法一覧

Confluence Cloudの新エディタ上で直接入力した際に、オートフォーマットによって即座にリッチテキストへと自動変換される主要なMarkdown記法を一覧表にまとめました。入力キーの直後に半角スペースやEnterキーを押すことが変換トリガーとなります。

装飾・要素 入力構文（キー操作） 変換トリガー 変換後の状態・挙動
見出し1〜6 # 〜 ###### 半角スペース 見出し1（大）〜 見出し6（極小）ブロックに変換
太字（ボールド） **テキスト** 末尾の ** 入力後 太字に変換（Ctrl+B / Cmd+B でも可）
斜体（イタリック） *テキスト* または _テキスト_ 末尾の * または _ 入力後 斜体に変換（Ctrl+I / Cmd+I でも可）
取り消し線 ~~テキスト~~ 末尾の ~~ 入力後 打ち消し線テキストに変換
インラインコード `コード` 末尾の ` 入力後 等幅フォント＆グレー背景枠に変換
箇条書きリスト * または - 半角スペース ビュレット（黒丸）付き箇条書きブロックに変換
番号付きリスト 1. 半角スペース 自動連番付きの番号リストブロックに変換
タスクリスト [] 半角スペース チェックボックス付きアクションアイテムに変換
引用ブロック > 半角スペース 左線付きの引用ブロックに変換
水平区切り線 --- または *** Enter 全幅の薄い区切り線（ディバイダー）に変換
ハイパーリンク [テキスト](URL) 閉じカッコ ) 入力後 クリック可能なアンカーリンクに自動変換
コードブロック ``` Enter 言語選択可能なコードブロックマクロ枠を展開
表（テーブル） ||見出し1||見出し2||
または |セル1|セル2|		 Enter ヘッダー付き／標準のConfluenceテーブルを生成

見出し（# 〜 ######）とテキスト装飾（太字・斜体・打ち消し・インラインコード）

ドキュメントの構造化に欠かせない 見出し記法 は、行頭で半角シャープ # を入力して半角スペースを打つだけで、即座にConfluenceの見出しスタイルへと変換されます。

📝 見出しの入力パターン：

  • # 見出し1 ＋ Space → 見出し 1（H1相当・大見出し）
  • ## 見出し2 ＋ Space → 見出し 2（H2相当・中見出し）
  • ### 見出し3 ＋ Space → 見出し 3（H3相当・小見出し）
  • #### 見出し4 ＋ Space → 見出し 4（H4相当）
  • ##### 見出し5 ＋ Space → 見出し 5（H5相当）
  • ###### 見出し6 ＋ Space → 見出し 6（H6相当）

文字装飾についても、標準的なMarkdown記法がそのまま利用可能です。アスタリスク2つで囲む **太字** や、チルダ2つで囲む ~~取り消し線~~ は、閉じ記号を入力した瞬間にオートフォーマットが作動します。また、プログラミングの変数名やファイルパスを記述する際に多用する インラインコード（バッククォート囲み `code`） も快適に動作します。

箇条書きリスト・番号付きリスト・タスクリスト（チェックボックス：[]）

業務マニュアルや議事録で頻出するリスト構造も、手軽な記法でスムーズに展開できます。

  • 箇条書きリスト： 行頭でハイフン - またはアスタリスク * を入力して半角スペースを押すと、黒丸付きの箇条書きに切り替わります。行末で Enter を押せば次のリスト項目が自動生成され、 Tab キーでインデント（階層下げ）、 Shift + Tab でインデント解除が可能です。
  • 番号付きリスト： 行頭で 1. と入力して半角スペースを押すと、自動連番リストになります。行を追加するたびに「2.」「3.」と連番が自動計算されます。
  • タスクリスト（アクションアイテム）： 行頭で角カッコ [] を入力して半角スペースを押すと、 Confluence固有の「アクションアイテム（チェックボックス）」 へと自動変換されます。このチェックボックスは閲覧画面上でもクリックして完了状態を切り替えられるほか、 @担当者名 によるメンションや //日付 による期日入力を組み合わせることで、実用的なタスク管理が完結します。

補足説明や他文書からの引用を明示する際、行頭に > （不等号大なり）を入力して半角スペースを押すと、左側に縦線が入った 引用ブロック（Blockquote） が挿入されます。

章と章の間に視覚的な仕切りを入れたい場合は、新しい行で --- （ハイフン3つ）または *** （アスタリスク3つ）を入力して Enter を押すことで、ページ横幅いっぱいに広がる薄い区切り線（ディバイダー）が瞬時に生成されます。

リンクの作成は、Markdown標準の [リンク表示名](https://example.com) を入力して閉じ丸カッコ ) を打つと、自動的にハイパーリンクへと変換されます。さらにConfluence Cloudでは、URLを直接貼り付けるだけでも「スマートリンク（カード表示、インライン表示、URL表示）」の切り替えが可能です。

表（テーブル：||heading|| や |cell|）の自動変換のコツ

Confluenceで最も実用性が高く、かつ入力のコツを掴むと作業効率が跳ね上がるのが 「表（テーブル）の自動生成記法」 です。

💡 Confluenceでの表自動生成の入力パターン：

  • ヘッダー行から始める場合： 行頭で ||項目1||項目2||項目3|| のように縦棒2本で各見出しを囲み、最後に Enter を押します。すると、グレー背景の太字ヘッダーを持つテーブル枠が生成されます。
  • 通常セルから始める場合： 行頭で |データ1|データ2|データ3| のように縦棒1本で囲んで Enter を押すと、通常のデータ行を持つテーブルが生成されます。

テーブルが一度生成された後は、セル内で Tab キーを押すだけで右隣のセルへ移動し、行末のセルで Tab を押せば自動的に新しい行が下に追加されます。ConfluenceのGUIツールバーでテーブルを探してクリックするよりも圧倒的に速く表を作成できるため、覚えておくべき必須テクニックです。

外部のMarkdownをConfluenceに綺麗に貼り付ける2つの方法

VS Code、Notion、GitHubのREADME、あるいはChatGPTなどの生成AIで作成した長文のMarkdown文書を、Confluenceのページに転記したい場面は非常に多いでしょう。しかし、何も考えずにエディタへそのまま貼り付けると、表が崩れたり記号が剥き出しになったりと悲惨な結果になりがちです。

外部のMarkdownをConfluence上で美しいレイアウトのまま反映させるための 「2つの確実な貼り付け手順」 を解説します。

方法1：「マークダウンマクロ（Markdown Macro）」を挿入して貼り付ける（おすすめ）

最も安全で、かつ複雑なMarkdown構造を一切崩さずに反映できる決定打が、Confluenceに用意されている 「マークダウンマクロ（Markdown Macro）」 を活用する方法です。

🚀 マークダウンマクロを使った貼り付け手順（ステップ解説）：

  1. Confluenceのページ編集画面で、新しい空行に半角スラッシュ /markdown と入力する。
  2. スラッシュコマンドの候補に表示される 「Markdown」マクロ をクリック（またはEnterで選択）する。
  3. ページ上に専用のグレー枠（マークダウンマクロの編集エリア）が挿入される。
  4. 外部ツールでコピーしたMarkdownテキストを、その枠内にそのままペースト（Ctrl+V / Cmd+V）する。
  5. 編集枠の外側をクリックするか、ページのプレビュー・公開を実行する。

マークダウンマクロの中に配置されたテキストは、ConfluenceのMarkdownレンダラーによって解析され、 見出し・太字・リスト・テーブル・コードブロックなどが完全に再現された状態でページ上にレンダリング されます。エディタのオートフォーマットで誤変換される心配が一切ないため、数十行〜数百行におよぶ長大な技術文書や設計書を一括で移植する際は、このマクロ経由の貼り付けが最も推奨されます。

⚠️ マークダウンマクロが見当たらない場合の注意点

ご契約のConfluence環境（Cloudの組織ポリシーやプラン設定、またはData Center版のバージョン）によっては、標準の「Markdown」マクロが無効化されている場合があります。もし /markdown でマクロがサジェストされない場合は、後述の「方法2」を利用するか、社内のAtlassian管理者にAtlassian Marketplaceのマクロプラグイン有効化をご相談ください。

方法2：ショートカットキー（Ctrl+Shift+V / Cmd+Shift+V）とオートフォーマットの併用

マクロを使わずに、Confluence標準のリッチテキスト要素として直接ページ内に展開したい場合は、 貼り付け時のショートカットキーと改行操作の組み合わせ を活用します。

Webブラウザや外部アプリから文字をコピーする際、目に見えないHTML装飾やスタイル属性がクリップボードに含まれていると、Confluenceのオートフォーマットが正常にトリガーされません。そこで、 「書式なしプレーンテキストとして貼り付ける」 のが鉄則です。

  • Windowsの場合： Ctrl + Shift + V （書式なし貼り付け）
  • Macの場合： Cmd + Shift + Option + V または Cmd + Shift + V

書式なしで貼り付けた際、Confluenceの新エディタは一部のMarkdown記法（箇条書きや見出しなど）を自動検知してリッチテキスト化を試みます。もし自動変換されずに ## 見出し や - リスト の文字列が残ってしまった場合は、 その行の先頭記号の直後にカーソルを置き、Backspace でスペースを消してから再度 Space を打ち直す と、オートフォーマットが強制的に発火して綺麗な見出しやリストへと瞬時に変換されます。

コードブロックマクロへの貼り付け手順

プログラムのソースコードや設定ファイル（JSON、YAML、SQLなど）をConfluenceで共有する場合は、インラインコードではなく 「コードブロックマクロ（Code Block）」 を使用します。

💻 コードブロックの展開と貼り付け手順：

  1. 空行で半角バッククォートを3つ ``` 入力して Enter を押す（または /code と入力して選択）。
  2. ダークグレーまたはライトグレーの専用コードブロック枠が挿入される。
  3. コードブロック右上のドロップダウンメニューから、対象のプログラミング言語（Python、JavaScript、Java、SQL、Bash、YAML等）を選択する。
  4. 外部でコピーしたソースコードを枠内に貼り付ける（Ctrl+V）。
  5. 必要に応じて、ツールバーのオプションで行番号の表示／非表示や折りたたみ設定を調整する。

コードブロックマクロを使用すると、キーワードが色分けされる シンタックスハイライト が適用され、可読性が飛躍的に向上します。また、右上のワンクリックコピー用ボタンが閲覧者に自動提供されるため、エンジニア間のコード共有が極めてスムーズになります。

外部ツール（ChatGPT・VS Code・Notion）からの実践コピペ手順

実務で頻繁に発生する「外部人気ツールで作成したドキュメントをConfluenceに持ってくる場面」ごとの最適な移行手順をまとめました。

📱 各ツールからの最適移行手順：

  • ChatGPT等の生成AIから： 回答吹き出しの下部にある「コピー」アイコンをクリックすると、リッチテキスト属性を持ったテキストがコピーされます。そのままConfluenceのエディタで Ctrl+V すると、見出しや太字、リストがリッチテキストとして綺麗に貼り付けられます。逆にコード枠内の生Markdownをコピーした場合は、Confluence側で /markdown マクロの中に貼り付けるのが安全です。
  • VS Codeから： .md ファイルのテキストを全選択してコピーした場合、プレーンテキスト形式になります。長文であればConfluence側で /markdown マクロ枠を挿入してペーストするのが最も確実です。マクロを使いたくない場合は、VS CodeのMarkdownプレビュー画面側で表示されたリッチテキストを選択コピーして貼り付ける裏技が有効です。
  • Notionから： Notionページ右上のメニュー「エクスポート」からMarkdown形式（.zip）で書き出し、展開した .md ファイルの中身をConfluenceの /markdown マクロに流し込むか、Notion上でテキストを選択コピーしてConfluenceに直接貼り付けます。Notion固有のコールアウトやトグルリストはConfluence側でパネル（/info）や展開マクロ（/expand）に置き換えると見栄えが整います。

ConfluenceでMarkdownを使う際によくあるトラブルと解決策

実務でConfluenceエディタを扱っていると、意図しない挙動やレイアウト崩れに遭遇することが少なくありません。代表的なトラブルの原因と具体的なリカバリー手法を整理しました。

コピペすると表やインデントが崩れるときの回避テクニック

外部のMarkdownで書かれたテーブル（GitHub Flavored Markdown: GFM形式）をConfluenceに普通にコピペすると、パイプ記号 | とハイフン - の文字列がそのまま段落テキストとして貼り付けられ、表として認識されない現象が頻発します。

🛠️ 表やインデント崩れを解決する3つの実践アプローチ：

  1. マークダウンマクロを経由させる： 前述の通り、 /markdown マクロの中に貼り付ければ、GFM形式のテーブル構文も100%忠実にグリッドテーブルとして展開されます。
  2. Confluence側で先に空のテーブルを作成しておく： エディタ上で /table または ||見出し|| で必要な列数の空テーブルを生成しておき、外部表の内容をスプレッドシート（ExcelやGoogleスプレッドシート）経由でセル単位コピー＆ペーストすると、自動で全セルに整然とマッピングされます。
  3. HTMLプレビュー経由でコピーする： VS CodeやTyporaのMarkdownプレビュー機能で一度HTML描画させ、そのプレビュー画面上で表を選択・コピーしてConfluenceに貼り付けると、リッチテキスト属性を持ったテーブルとして美しくインポートされます。

Markdown形式でのエクスポート・他ツールへの移行方法

「Confluenceに蓄積したドキュメントを、GitHubのWikiやNotion、社内ローカルのMarkdownファイル群として移行・バックアップしたい」という需要は近年急速に高まっています。

しかし注意点として、 Confluenceの標準エクスポート機能は「PDF」「Word」「HTML」形式のみであり、Markdown（.md）形式のネイティブ出力には対応していません 。

ConfluenceのページをMarkdownとして書き出す場合は、以下のいずれかの方法を採用するのが一般的です：

  • Atlassian Marketplaceの専用プラグイン： 「Markdown Exporter for Confluence」などのサードパーティアドオンを導入することで、ページやスペース単位で一括.mdダウンロードが可能になります。
  • Pandoc（パンドック）による変換： ConfluenceからHTML形式またはWord（.docx）形式で一度エクスポートし、オープンソースの汎用ドキュメント変換ツール「Pandoc」を用いてコマンドラインでMarkdownへ一括変換します（例: pandoc -f html -t markdown input.html -o output.md）。
  • REST APIとスクリプト連携： エンジニアチームであれば、Confluence REST APIからページ本文（ADFまたはストレージフォーマットHTML）を取得し、自作スクリプトでMarkdownへとマッピング変換するパイプラインを構築することも可能です。

ConfluenceのMarkdown利用に関するよくある質問（FAQ）

ConfluenceでのMarkdown入力やエディタ操作に関して、社内ユーザーやエンジニアから頻繁に寄せられる質問をFAQ形式で整理しました。

Q1. Confluenceで一度変換された書式を元のMarkdown記法に戻せますか？

A. オートフォーマット直後であれば、キーボードの Ctrl + Z （Macは Cmd + Z）を押すことで直前の自動変換を取り消し、入力した生のMarkdown記号（例: # 見出し や - リスト）の状態へ戻すことができます。ただし、一度ページを保存・公開してしまったり、時間が経過して別の編集を行ったりした後は、内部データがリッチテキスト（ADF）として固定されるため、元のMarkdown記法へ自動逆変換することはできません。Markdownのプレーンテキストとして管理し続けたいドキュメントは、「マークダウンマクロ」の中に記述して保存することをおすすめします。

Q2. Data Center版 / Server版でも同じようにオートフォーマットは使えますか？

A. バージョンとエディタ形式によって挙動が異なります。オンプレミス環境の「Confluence Data Center」において従来のクラシックエディタを使用している場合、標準の入力画面はWYSIWYGエディタであり、Cloud新エディタほど広範なMarkdownオートフォーマットは動作しません。ただし、Data Center版でも「マークダウンマクロ」や「挿入 > マークアップ（Wikiマークアップ / Markdown）」メニューからMarkdownテキストを流し込む機能が標準装備されているため、外部文書の取り込みは十分可能です。組織の環境に応じてエディタの入力仕様をご確認ください。

Q3. エディタ上でショートカット一覧をすぐに確認する方法は？

A. Confluenceのページ編集画面を開いた状態で、キーボードの Ctrl + / （Macは Cmd + /）または ? （Shift + /）を押すと、画面中央に 「キーボードショートカット一覧モーダル」 がポップアップ表示されます。オートフォーマットのトリガー記法やテキスト装飾、ブロック挿入の全ショートカットをいつでもその場で確認できるため、ブックマーク感覚で活用するとタイピング効率がさらに向上します。

まとめ｜ConfluenceのMarkdown機能を使いこなしてWiki作成を爆速化しよう

今回は、社内情報共有のデファクトスタンダードであるConfluenceにおけるMarkdown対応状況と、実務で絶対に役立つ自動変換記法・コピペ崩れ対策を徹底解説しました。

📝 本記事の重要ポイント総まとめ

  • 新エディタの基本思想： 純粋なMarkdownエディタではなく、「オートフォーマットによるリッチテキストへのリアルタイム変換」を採用。
  • タイピング効率化： 見出し（# ）、リスト（- / 1. ）、チェックボックス（[] ）、表（||見出し||）をキー入力で瞬時に生成可能。
  • 外部Markdownのコピペ崩れ防止： 長文やテーブルを含む外部ドキュメントは、スラッシュコマンド /markdown から マークダウンマクロ枠 を挿入して貼り付けるのが最も確実。
  • ソースコード共有： ``` や /code によるコードブロックマクロを活用し、シンタックスハイライトと行番号表示で視認性を最大化する。

Confluenceの入力特性を正しく理解し、オートフォーマットとマークダウンマクロを状況に応じてスマートに使い分けることで、社内ドキュメントや仕様書の作成スピードは飛躍的に高まります。日々のWiki作成やナレッジ共有の生産性向上に、ぜひ本記事のテクニックを役立ててください！

1 COMMENT

コメントを残す

メールアドレスが公開されることはありません。 ※ が付いている欄は必須項目です

前の記事

【徹底比較】Notion vs Obsidian！用途別の選び…

次の記事

【コピペで使える】振り返り＆目標設定Markdownテンプレー…