マークダウンをWordPressに貼り付ける方法|ブロックエディタの自動変換を使う手順と注意点
公開日: / カテゴリ: WordPress入稿 / 執筆: エラバレル

「エディタでマークダウンを使って書いた記事を、そのままWordPressに入れたい」「貼り付けたら『##』や『**』がそのまま文字で出てしまった」。ふだんからマークダウンで文章を書いているブロガーやエンジニアから、こうした声をよく聞きます。
先に結論をお伝えします。WordPressのブロックエディタは、マークダウンの文章を「段落のブロック」に貼り付けると、見出し・リスト・太字・リンク・コードなどを自動でブロックに変換してくれます。 プラグインを入れなくても、多くの場合はこれで十分です。うまく変換されないときは、貼り付ける場所と、貼り付けるときの形式を確かめると、ほとんど解決します。
この記事では、ブロックエディタの自動変換の手順と、変換される書き方・されない書き方、表や画像の注意点を説明します。あわせて、プラグインを使う方法や、Googleドキュメントを経由して入稿する方法も比べます。
この記事でわかること
- マークダウンとWordPressの関係
- ブロックエディタにマークダウンを貼り付ける手順
- 変換される書き方と、されない書き方
- 表・画像・コードを貼るときの注意
- うまく変換されないときの確認箇所
- プラグインやGoogleドキュメント経由の入稿との比較
マークダウンとは? WordPressとの関係
マークダウン(Markdown)は、# や * などの記号を使って、見出しや箇条書きを表す、シンプルな書き方のルールです。たとえば、行の先頭に ## を付けると見出し、- を付けると箇条書き、文字を ** で囲むと太字になります。
文字だけで書けるので、どんなテキストエディタでも使え、書いている途中で見た目に気を取られずに済むのが長所です。ファイルが軽く、変更の履歴も管理しやすいので、記事の原稿をフォルダごと保管しておく人にも向いています。エンジニアの技術文書や、GitHubのREADME、ノートアプリなどで広く使われています。
一方、WordPressの記事は、ブロックエディタで「見出しブロック」「段落ブロック」「リストブロック」のような部品を並べて作ります。マークダウンをWordPressに入れるということは、記号で書かれた構造を、WordPressのブロックに置き換えることです。
マークダウンには「方言」がある
マークダウンには、基本のルールのほかに、表や取り消し線、チェックボックスなどを足した「拡張」の書き方がいくつもあります。GitHubで使われている書き方(GitHub Flavored Markdown)が代表的です。書いている場所で使えた書き方が、別の場所では使えないこともあるので、変換がうまくいかないときは、拡張の書き方を使っていないかも見てみてください。
ブロックエディタにマークダウンを貼り付ける手順
WordPress標準のブロックエディタ(Gutenberg)には、マークダウンの文章を貼り付けたときに、自動でブロックに変換する機能があります。
手順
- マークダウンで書いた原稿を、テキストエディタなどで開きます
- 本文をすべて選んで、「Ctrl+C」(Macは「command+C」)でコピーします
- WordPressの管理画面で「投稿」→「新規投稿を追加」を開きます
- タイトルの欄にタイトルを入れます(原稿の先頭の
# タイトルの行は、本文には含めずにここに入れます) - 本文の最初の空の段落をクリックします
- 「Ctrl+V」(Macは「command+V」)で貼り付けます
- 見出し・リスト・コードなどが、それぞれのブロックに分かれて入ったかを確かめます
うまくいけば、## 見出し の行は見出しブロック(h2)に、- 項目 の行はリストブロックに、バッククォート3つで囲んだ部分はコードブロックに、それぞれ変わります。
「空の段落ブロック」に貼るのがコツ
自動の変換は、段落ブロックに文字だけの内容を貼り付けたときに働きます。新しい空の段落ブロックをクリックしてから貼るのが、確実に変換させるコツです。コードエディタの画面や、クラシックのブロックの中に貼ると、記号がそのまま文字として入ってしまいます。
変換される書き方と、されない書き方
ブロックエディタの自動変換で、よく使う書き方がどうなるかを表にまとめました。WordPressのバージョンによって結果が変わることがあるので、目安として見てください。
| マークダウンの書き方 | 変換後 | 注意 |
|---|---|---|
## 見出し、### 見出し | 見出しブロック(h2、h3) | #(h1)は本文に使わず、タイトル欄に入れる |
- 項目、1. 項目 | リストブロック(箇条書き・番号つき) | 入れ子のリストは、字下げのしかたで崩れることがある |
**太字**、*斜体* | 太字・斜体 | 記号の前後に空白がないと変換されないことがある |
[文字](URL) | リンク | URLにかっこが含まれると崩れることがある |
| バッククォート3つで囲んだコード | コードブロック | 言語の指定(jsなど)は、表示に反映されないことがある |
| バッククォート1つで囲んだ文字 | 文中のコード | 問題なく変換されることが多い |
> 引用 | 引用ブロック | |
| 表(縦線で列を区切る書き方) | 表ブロック | 崩れた場合は、表ブロックで作り直す |
 | 画像ブロック | 画像はWordPressに保存されない(後述) |
---(区切り線) | 区切りブロック |
表・画像・コードを貼るときの注意
表
マークダウンの表は、1行目に列の名前、2行目に |---|---| の区切り、3行目からデータを書きます。ブロックエディタに貼ると、表ブロックに変換されることが多いですが、セルの中に | を含む、行ごとの列の数がそろっていない、といった場合は崩れます。
変換されたら、表ブロックを選んで、1行目が見出しの行(ヘッダー)になっているかも確かめてください。表ブロックの設定に、ヘッダーの行を付けるかどうかを切り替える項目があります。
画像
マークダウンの画像の書き方  を貼ると、画像ブロックに変わります。ただし、画像そのものはWordPressに保存されず、書いたURLの画像を参照するだけです。
画像のURLが、自分のパソコンの中のファイル(./images/photo.png など)を指している場合は、WordPressからは見えないので、画像は表示されません。外部のサイトの画像を指している場合も、その画像が消えれば記事の画像も消えてしまいます。
画像は、WordPressの「メディア」にアップロードしてから、画像ブロックで入れ直すのが確実です。画像ブロックを選んだときに、外部の画像を取り込むためのボタンが表示される場合は、それを使ってメディアライブラリに保存することもできます。詳しくはWordPressの「外部画像をアップロード」の記事で説明しています。
画像の「説明」は alt になる
 の「説明」の部分は、変換後の画像ブロックの代わりの文章(alt)に入ることが多いです。画像の内容が分かる文を書いておくと、そのまま alt として使えます。書き方は画像のaltの書き方の記事で説明しています。
コード
技術ブログでは、コードの表示がいちばん気になるところです。バッククォート3つで囲んだコードは、コードブロックに変換されます。コードの中の < や >、& などの記号も、コードブロックの中ならそのまま表示されます。
ただし、言語ごとの色分け(シンタックスハイライト)は、ブロックエディタの標準の機能ではありません。色分けをしたい場合は、テーマの機能や、色分け用のプラグインを使います。長いコードを載せる場合は、スマホで見たときに横にはみ出していないかも確かめておきましょう。
うまく変換されないときの確認箇所
「貼り付けたら、## や ** がそのまま文字で出てしまった」というときは、次の点を確かめてください。
確認1:貼り付けた場所
段落ブロック以外(クラシックのブロック、カスタムHTMLのブロック、コードのブロック、コードエディタの画面)に貼ると、変換されません。新しい段落ブロックを作って、そこに貼り直してください。
確認2:コピー元の形式
いちばん多い原因がこれです。記号が見えている状態の文字をコピーすることを覚えておいてください。マークダウンを表示する画面(プレビュー)からコピーすると、記号ではなく、見た目の整った文章(リッチテキスト)としてコピーされます。この場合、ブロックエディタはそれをふつうの文章として貼り付けます。マークダウンの記号が見えている「編集の画面」からコピーしてください。
確認3:プレーンテキストとして貼り付けたか
コピー元によっては、文字の書式がいっしょにコピーされ、マークダウンとして認識されないことがあります。その場合は、一度メモ帳などのテキストエディタに貼り付けてから、改めてコピーし直すと、文字だけになります。
確認4:空行の入れ方
マークダウンでは、段落と段落の間、見出しの前後、リストの前後に、空の行を1行入れるのが基本です。空行がないと、見出しの行が前の段落とつながって、ふつうの文章として扱われることがあります。
確認5:変換したくない記号
逆に、文章の中の * や _、# が、意図せず太字や見出しに変わってしまうこともあります。たとえば、行の先頭に #1 のような番号を書くと、見出しと間違えられることがあります。記号の前に \ を付けると、記号として扱われます。
変換がうまくいかないときのチェックリスト
- 新しい段落ブロックをクリックしてから貼り付けた
- マークダウンの記号が見える「編集の画面」からコピーした
- 見出し・リスト・表の前後に、空の行を入れている
- 記号の前後の空白が、ルールどおりになっている
- 一度テキストエディタを通して、文字だけの状態にした
- WordPressが新しいバージョンに更新されている
WordPressに入れる前提で、マークダウンを書くコツ
貼り付けたあとの手直しを減らすには、書く段階で少し気をつけておくのが近道です。WordPressに入れることを前提にした、マークダウンの書き方のコツを紹介します。
先頭に、記事の設定をメモしておく
マークダウンのファイルの先頭に、スラッグ(URLの末尾)、カテゴリ、タグ、説明文などをメモしておくと、入稿のときに迷いません。静的サイトの仕組みでよく使われる「---」で囲んだ設定の欄(フロントマター)を書く人もいますが、ブロックエディタに貼るときは、この部分は本文に含めずにコピーしてください。そのまま貼ると、区切り線や文章として入ってしまいます。
見出しは h2 から始め、階層を飛ばさない
WordPressでは、記事のタイトルが h1 になるのが一般的です。本文の見出しは ## (h2)から始め、その下を ### (h3)にします。h2 の次にいきなり h4 を使うなど、階層を飛ばさないようにすると、目次のプラグインなども正しく動きます。
画像は、先にアップロードしてURLを差し替える
画像の多い記事は、書き終えた時点で画像を先にWordPressのメディアにアップロードし、マークダウンの中の画像のURLを、WordPressの画像のURLに置き換えてから貼り付けると、あとで画像を入れ直す手間がなくなります。メディアライブラリで画像を選ぶと、そのURLをコピーできます。
1つの段落を長くしすぎない
マークダウンでは、改行を1つ入れただけでは段落が分かれず、空の行を入れてはじめて別の段落になります。スマホで読むことを考えると、1つの段落は3〜4文までにして、話題が変わったら空の行で区切るのがおすすめです。
テーマ独自の装飾は、貼り付けたあとに足す
吹き出しやボックスなど、テーマ独自の装飾は、マークダウンでは書けません。原稿では「(ここに注意のボックス)」のようにメモを残しておき、貼り付けたあとにブロックを差し込むと、作業の漏れを防げます。
ほかの入稿方法との比較
ブロックエディタの自動変換のほかにも、マークダウンをWordPressに入れる方法があります。
Markdownのブロックを使う
Jetpackなどのプラグインには、マークダウンをそのまま書けるブロックが含まれているものがあります。ブロックの中にマークダウンを書くと、表示のときに見た目に変換されます。編集のときもマークダウンのまま直せるのが長所ですが、記事全体がそのブロックに入るため、ほかのブロックとの組み合わせはしにくくなります。
マークダウン用のプラグインを使う
WordPressの編集画面そのものを、マークダウンで書く画面に変えるプラグインもあります。マークダウンで書くことに慣れている人には便利ですが、ブロックエディタの機能(テーマのブロックや、パターン)が使いにくくなることがあります。プラグインを選ぶときは、更新が続いているかも確かめてください。
Googleドキュメントを経由する
チームで原稿を確認・修正してから入稿する場合は、マークダウンの原稿をGoogleドキュメントに取り込み、そこからWordPressに入れる方法もあります。Googleドキュメントでは、「ツール」→「設定」でマークダウンを有効にすると、マークダウンの文章を見出しやリストに変換して貼り付ける機能が使えます。コメントや提案のモードで修正をやり取りできるので、外注のライターや編集者と一緒に作業するときに便利です。詳しくはGoogleドキュメントをマークダウンに変換する方法で説明しています。
Googleドキュメントにした原稿は、エラバレルの「ドクポス」を使うと、URLを貼るだけでWordPressの記事にできます。見出し・リスト・表・リンク・画像をWordPressのブロックに変換し、画像はメディアライブラリにアップロードした状態で入ります。マークダウンを直接貼る方法で手間になりやすい「画像の取り込み」を、まとめて済ませられるのが違いです。
| 方法 | 向いている人 | 画像 | 手間 |
|---|---|---|---|
| ブロックエディタに貼る | 1人で書いて、月に数本入稿する | 手作業でアップロード | 少ない |
| Markdownのブロック | 公開後もマークダウンのまま直したい | 手作業でアップロード | 少ない |
| マークダウン用のプラグイン | 編集画面ごとマークダウンにしたい | プラグインによる | 設定が必要 |
| Googleドキュメント経由 | チームで原稿を確認してから入稿する | ツールによっては自動 | 取り込みの手間がかかる |
エンジニアのブロガーの使い分けの例
ふだんの技術メモ:エディタでマークダウンを書き、ブロックエディタに貼り付けて公開
画像の多い解説記事:画像を先にメディアにアップロードし、マークダウンの画像のURLをWordPressのURLに置き換えてから貼り付け
外注のライターと作る記事:Googleドキュメントで原稿をやり取りし、確認が済んだらツールで入稿
貼り付けたあとに確認したいこと
記事を公開する前に、プレビューで次の点を確かめます。
- 見出しの順番(h2の下にh3)が、原稿どおりになっているか
- リンクが正しいURLになっているか
- 表がスマホの幅で崩れていないか
- 画像がWordPressのメディアから表示されているか
- コードの中の記号が、意図せず変わっていないか
見出しの順番は、読む人だけでなく、検索エンジンやAIが記事の内容を理解する手がかりにもなります。選ばれるAI診断で22業種・2,296件の公式サイトを診断したところ、見出しの構造に不足があったサイトは53%ありました。マークダウンで書く人は、見出しの階層を意識していることが多いので、その構造をWordPressにそのまま移せるのは大きな長所です。
よくある質問
プラグインを入れないと、マークダウンは使えませんか?
ブロックエディタに貼り付けるだけなら、プラグインは要りません。段落ブロックに貼ると、自動でブロックに変換されます。編集の画面でもマークダウンのまま書きたい場合は、プラグインを検討してください。
ブロックエディタで、直接マークダウンの記号を打って書けますか?
段落ブロックの先頭で ## と打つと見出しに、- と打つとリストに変わるなど、一部の書き方は入力しながら変換されます。ただ、すべての書き方に対応しているわけではないので、長い原稿は別のエディタで書いて貼り付けるほうが楽です。
クラシックエディタでも、マークダウンを貼れますか?
クラシックエディタには、マークダウンを自動で変換する機能はありません。マークダウンをHTMLに変換してから貼り付けるか、ブロックエディタに切り替えて貼り付けてください。
貼り付けた記事を、あとでマークダウンに戻せますか?
ブロックエディタには、記事をマークダウンに書き出す標準の機能はありません。原稿のマークダウンのファイルは、別に保存しておくことをおすすめします。
表がうまく変換されません。
1行目の列の名前、2行目の区切り(|---|---|)、3行目からのデータという形になっているか、行ごとの列の数がそろっているかを確かめてください。それでも崩れる場合は、表ブロックを追加して、そこに作り直すのが確実です。
数式やチェックボックスは変換されますか?
数式やチェックボックスは、マークダウンの拡張の書き方で、ブロックエディタの自動変換では、ふつうの文字として入ることがあります。数式を表示したい場合は、数式用のプラグインなどを使ってください。
生成AIが出力したマークダウンも、同じように貼れますか?
貼れます。ChatGPTなどが出力する文章は、見出しや箇条書きがマークダウンで書かれていることが多く、記号が見える形でコピーできれば、同じ手順でブロックに変換されます。ただし、内容が正しいかの確認と、自分の言葉での書き直しは欠かせません。事実と違うことが書かれていないか、公開の前に必ず読み直してください。
まとめ
マークダウンの原稿は、ブロックエディタの段落ブロックに貼り付けるだけで、ほとんどの書き方がブロックに変換されます。
この記事のまとめ
- ブロックエディタは、段落ブロックに貼ったマークダウンを、見出し・リスト・コード・表などのブロックに自動で変換する
- 新しい空の段落ブロックをクリックしてから、記号が見える編集の画面からコピーして貼る
#(h1)はタイトル欄に入れ、本文は##から始める- 画像はWordPressに保存されない。メディアにアップロードして入れ直す
- 変換されないときは、貼り付けた場所・コピー元の形式・空行の入れ方を確かめる
- チームで原稿を確認するなら、Googleドキュメントを経由して入稿する方法もある
画像の多い記事や、チームで確認した原稿の入稿を自動にしたい場合は、GoogleドキュメントのURLを貼るだけでWordPressの記事を作れるドクポスを試してみてください。5記事まで、カード登録なしで試せます。
ドクポスを無料で試すあわせて読みたい記事:
参考にした資料
- WordPress Block Editor(WordPress.org・英語)
- Markdown のガイド(Daring Fireball・英語:Markdown Syntax Documentation)
調査の方法:見出しの構造の割合は、2026年10月2日に見直した採点基準で、選ばれるAI診断が22業種の公式サイト2,296件を再診断した結果のうち、「不足」または「一部不足」と判定されたサイトの割合です。個別のサイト名は公開していません。