Amazonで商品を見る セール会場へ

HTMLエスケープとは|エスケープ文字の一覧と変換方法、WordPress・PHP・JavaScriptでの処理

HTMLエスケープとは、<や&のようにHTMLで特別な意味を持つ文字を、&lt;などの「文字参照」に置き換えて、ただの文字として表示させる処理です。

変換するのは&・<・>・"・'の5文字で、&をいちばん先に変換します。

ブログに貼ったコードが消えてリンクや太字になるのは、「<」や「>」がタグとして読まれるためです。

最終確認日:2026年9月28日

目次

著者

WEB制作をしているデジタルノマド
WordPressのカスタマイズが好きで、色々と自作しています。

WordPressのカスタマイズに困ったらご相談ください!

この記事で分かること

  • エスケープが必要な5つの文字と、変換後の形
  • 「&」を最初に変換しないといけない理由
  • ツールで変換する手順と、元に戻す方法
  • WordPressでコードやショートコードを文字として見せる方法
  • PHP・JavaScript・Pythonでエスケープ処理を書く方法
スポンサーリンク

答え|変換するのは5文字

HTMLで特別な意味を持つ文字は、次の5つです。

スクロールできます
文字変換後変換が必要な場面
&&amp;HTMLソースへ文字として出力するとき(手作業では最初に変換)
<&lt;HTMLソースへ文字として出力するとき
>&gt;HTMLソースへ文字として出力するとき
"(半角)&quot;ダブルクォートで囲む属性値の中
'(半角)&#39;(&#x27;でも同じ)シングルクォートで囲む属性値の中

本文にコードを載せるだけなら、上の3つを変換すれば表示は崩れません。

href="…"のような属性値では、その値を囲む半角の引用符もエスケープします。

URLを出力する場合は、HTMLの文字置換だけでなくURL用の処理が必要です。

5文字以外のエスケープ文字一覧|よく使う文字参照

&lt;のように「&」で始まり「;」で終わる書き方を、文字参照と呼びます。

名前の付いた文字参照は5文字のほかにも数多くあり、よく使うのは次のとおりです。

スクロールできます
書き方表示用途
&nbsp;(改行しない空白)単語の途中で改行させたくないとき
&copy;©著作権表示
&reg;®登録商標
&yen;¥円記号
&times;×掛け算の記号、閉じるボタン
&#60;/&#x3C;<数値で書いた「<」(10進数と16進数)

名前の付いた文字参照の全一覧の置き場所は、HTMLの仕様書(WHATWG HTML Standard の Named character references)です。

文字参照の仕組みは、MDNの「文字参照」でも解説されています。

ページの文字コードがUTF-8なら、「©」や「¥」は文字参照にしなくても、そのまま書いて表示できます。

文字参照にしないと崩れるのは、あくまで5文字のほうです。

順番が大事|「&」をいちばん先に変換する

変換後の形は、どれも「&」で始まるのが特徴です。

そのため、「<」を先に「&lt;」に変えてから「&」を変換すると、いま作った「&lt;」の「&」まで変換されてしまいます。

変換の順番「<p>」の結果
& → < → >(正しい順番)&lt;p&gt;
< → > → &(間違った順番)&amp;lt;p&amp;gt;

間違った順番では「&amp;lt;」のような二重変換の形になり、ページには「&lt;p&gt;」と記号のまま表示されます。

エディターの置換機能で手作業で変換するときは、この順番に気をつけてください。

ツールで変換する|貼るだけで変換される

この記事で使うHTML特殊文字変換は、当サイトと同じMOTOKI合同会社が作った「WEBツール箱」の1つです。

無料で、会員登録なしで使えます。

掲載画面は2026年9月28日時点の例です。

コアのコードブロックについて本文に記した確認範囲と、変換ツールの全機能・他のコードブロックの動作は別です。

ツールの全機能と各テーマ・プラグインのコードブロックは再確認していません。

  1. HTML特殊文字変換を開く
  2. 変換したいコードを貼る
  3. 「変換の向き」で「特殊文字に変換(エスケープ)」を選ぶ
  4. 変換結果をコピーする

入力と同時に変換されるので、変換のボタンはありません。

リンクのタグを1行、エスケープした結果です。

HTML特殊文字変換でリンクのタグをエスケープした結果
リンクのタグをエスケープした結果(2026/09/28時点の表示)

「引用符も変換する」にチェックを入れると、半角のダブルクォート"も&quot;に変換されます。

全角の引用符や曲がった引用符とは別の文字です。

変換前の45文字が、変換後は71文字です。

下の「ページ上での見え方」は、変換後のコードを貼ったときにページにどう出るかを表しています。

「半角スペースを &nbsp; にする」にチェックを入れると、半角スペースも「&nbsp;」に置き換わります。

ふつうは使いませんが、スペースを連ねて字下げした部分をそのまま見せたいときに役立つ設定です。

二重に変換されたときは「元に戻す」

「&amp;lt;」のように「amp;」が重なっていたら、二重に変換された状態です。

すでにエスケープされた文字列を、もう一度エスケープすると起きます。

「変換の向き」を「元の文字に戻す(アンエスケープ)」にして貼ると、1段階だけ戻せます。

HTML特殊文字変換で二重に変換された文字列を元に戻した結果
二重に変換された文字列を、1回だけ元に戻した結果(2026/09/28時点の表示)

二重に変換された文字列が、1回で正しいエスケープの形に戻りました。

戻した結果をもう一度戻すと、今度は元のタグになります。

amp;という文字自体が原文の場合もある点に注意してください。

回数だけで判断せず、元データと照合して必要な1段階だけ戻します。

WordPressでコードを載せるとき

ブロックエディターの「コード」ブロックに貼るなら、エスケープは自動で行われるので、このツールは要りません。

変換が必要になるのは、次のような場面です。

  • カスタムHTMLブロックの中に、コードを文字として見せたいとき
  • テーマやプラグインのファイルに、説明用のコードを直接書くとき
  • 段落の中に、タグの名前を文字として書きたいとき
  • WordPress以外のサイトやメールマガジンに、コードを載せるとき

<script>を含むコードをカスタムHTMLブロックに貼ると、保存時の権限やフィルターによっては実行可能なHTMLとして残ります。

コードを読ませる用途では、実行可能なHTMLとして貼らないでください。

例えば、次のコードを見せたいときです。

<script>
  alert("test");
</script>

この例が実行可能なHTMLとして残り、ブラウザーの制限などで遮断されなければ、ページを開いたときに実行されます。

エスケープしてから貼れば、文字として表示されます。

ショートコードは、エスケープでは止まらない

WordPressの「ショートコード」は、角かっこで囲んで使う仕組みです。

本文に [gallery] と書くと、その場所に画像のギャラリーが表示されます。

角かっこは、HTMLの特殊文字ではありません。

そのため、HTMLのエスケープをしても、ショートコードは文字としては表示されず、そのまま実行されます。

ショートコードを文字として見せたいときは、角かっこを二重にして [[gallery]] と書きます。

こう書くと、ページには外側の角かっこが1組外れた [gallery] が表示され、実行はされません。

なお、コアの「コード」ブロックは、保存するときに「[」を「&#91;」という形に置き換えています。

このサイトのWordPressが読み込んでいるブロックのプログラムで、2026年9月28日にこの処理を確かめました。

コードブロックの中なら、ショートコードが実行されないのはこのためです。

なぜエスケープが必要か|表示崩れと安全のため

エスケープは、表示を崩さないためだけのものではありません。

お問い合わせフォームなどで利用者が入力した内容を、エスケープせずにページに出すと、悪意のあるスクリプトが実行されてしまいます。

これがXSS(クロスサイトスクリプティング)です。

WordPressでテーマやプラグインを自作するときは、出力する場所に合わせて処理を選びます。

通常の本文文字列はesc_html()、一般の属性値はesc_attr()、リンクなどのURLはesc_url()を使います。

HTMLを許可する場合やJavaScript内に値を渡す場合は、それぞれの用途に合う処理が必要です。

このツールは、その変換を手作業で確かめたいときにも使えます。

エスケープ処理をプログラムで書く|PHP・WordPress・JavaScript・Python

自分でプログラムを書くときは、置換を手で並べるより、各言語に用意された関数を使うのが確実です。

スクロールできます
言語使う関数単引用符の変換結果
PHPhtmlspecialchars()&#039;(ENT_QUOTESを指定したとき)
WordPressesc_html()・esc_attr()&#039;
JavaScript標準の関数なし(textContentか自作の関数)自作の関数しだい
Pythonhtml.escape()&#x27;

&#039;・&#39;・&#x27;は書き方が違うだけで、どれも同じ単引用符を表します。

PHP:htmlspecialchars()

<?php
$text = '<a href="/">Tom & Jerry\'s</a>';
echo htmlspecialchars($text, ENT_QUOTES, 'UTF-8');
// &lt;a href=&quot;/&quot;&gt;Tom &amp; Jerry&#039;s&lt;/a&gt;

第2引数にENT_QUOTESを渡すと、二重引用符と単引用符の両方が変換されます。

PHP 8.1より前は、引数を省くと単引用符が変換されませんでした(PHPマニュアルの変更履歴に記載があります)。

古い環境でも同じ結果にするには、ENT_QUOTESと文字コードを明示しておきます。

元に戻す関数はhtmlspecialchars_decode()です。

結果が空になるときは、入力に指定した文字コードとして不正なバイト列が混じっていないかを確かめてください。

PHPマニュアルによると、不正なバイト列があるとENT_IGNOREかENT_SUBSTITUTEを指定しない限り空文字列が返ります。

ENT_QUOTES | ENT_SUBSTITUTEと指定すれば、不正な部分を置換文字に変えて処理を続けます。

WordPress:esc_html()・esc_attr()・esc_url()

<h2><?php echo esc_html( $title ); ?></h2>
<a href="<?php echo esc_url( $url ); ?>" title="<?php echo esc_attr( $label ); ?>">詳しく見る</a>

テーマやプラグインで使うのは、PHPの関数ではなくWordPressの関数です。

esc_html()は内部で_wp_specialchars()を呼んでいて、すでに文字参照になっている部分をもう一度変換しません。

そのため、htmlspecialchars()の既定の動きと違い、「&amp;lt;」のような二重変換が起きにくい作りです。

JavaScript:textContent か、置換する関数を書く

JavaScriptには、HTMLエスケープ専用の標準の関数がありません。

画面に文字として出すだけなら、innerHTMLではなくtextContentに入れれば、タグとして解釈されずにそのまま表示されます(MDNのtextContent)。

const el = document.querySelector('#output');
el.textContent = '<b>太字にならない</b>'; // そのまま文字として表示される

HTMLの文字列そのものを組み立てる必要があるときは、次のような関数を書きます。

function escapeHtml(str) {
  return str
    .replace(/&/g, '&amp;')
    .replace(/</g, '&lt;')
    .replace(/>/g, '&gt;')
    .replace(/"/g, '&quot;')
    .replace(/'/g, '&#39;');
}

console.log(escapeHtml('<a href="/">Tom & Jerry\'s</a>'));
// &lt;a href=&quot;/&quot;&gt;Tom &amp; Jerry&#39;s&lt;/a&gt;

よくある失敗は、&の置換を最後に書いてしまうことです。

そうすると、先に作った「&lt;」の「&」まで変換されて、二重変換になります。

置換の順番は、この記事の前半で説明した手作業のときと同じで、&が先頭です。

Python:html.escape()

import html

text = '<a href="/">Tom & Jerry\'s</a>'
print(html.escape(text))
# &lt;a href=&quot;/&quot;&gt;Tom &amp; Jerry&#x27;s&lt;/a&gt;

html.escape()は、既定で二重引用符と単引用符も変換します。

引用符を残したいときはquote=Falseを渡し、元に戻すときはhtml.unescape()を使います。

ツールの限界

  • 変換するのは「&」「<」「>」と引用符、指定したときの半角スペースだけ
  • 日本語や絵文字は、そのまま残す
  • JavaScriptの文字列やURLの中に入れる値の変換には使えない
  • 角かっこは変換しないので、ショートコードを止めるには二重の角かっこを使う

URLの中に入れる値の変換は、URLエンコード・デコードで行います。

よくある質問

Q. 貼ったコードはどこかに送られますか?

送られません。

変換処理はブラウザー内で行う設計です。

ただし、この説明だけでページ全体や拡張機能による通信まで保証できません。

秘密鍵や認証情報を含むコードは貼らず、架空のサンプルで確認してください。

Q. 「&#39;」と「&apos;」はどちらを使えばよいですか?

どちらも「’」を表します。

ツールが出力するのは「&#39;」です。

「&apos;」は古いHTMLの仕様には無かったので、「&#39;」のほうが幅広い環境で通ります。

Q. コードブロックに貼ったのに表示が崩れます

コードブロックではなく、カスタムHTMLブロックや段落に貼っていないかを確かめてください。

テーマやプラグインのコードブロックを使っている場合は、そのブロックがエスケープするかどうかも確かめます。

自動でエスケープするブロックへ変換済みの文字を貼ると二重変換になります。

まず短いサンプルを未変換で貼り、保存後の公開表示を確認するのが確実です。

HTMLソースへ直接埋め込む場合だけ、その出力位置に合うエスケープを行います。

スポンサーリンク

まとめ

  • HTMLソースへ文字として出力する際に扱うのは、&・<・>と、半角の"・'。出力位置に合わせて処理を選ぶ
  • 「&」をいちばん先に変換しないと、二重変換になる
  • 二重に変換されたら、「元の文字に戻す」で1段階ずつ戻す
  • WordPressのコードブロックは自動でエスケープするが、カスタムHTMLブロックはしない
  • ショートコードを文字として見せるには、角かっこを二重にする
  • プログラムではhtmlspecialchars()・esc_html()・html.escape()などの関数を使い、JavaScriptはtextContentに入れる

ほかの項目もまとめて点検するなら、「WordPressサイトを自分で点検する手順」で順番と使い分けを解説しています。

ツールの一覧はWEBツール箱にあります。

  • URLをコピーしました!

制作・運用のご依頼はこちら

MOTOKI合同会社のサービス

WordPressの制作・カスタマイズ・高速化・SEO対策・保守まで、Webサイトに関する業務を一括で承ります。料金はサービスごとに公開しています。

WAZAの有料記事のサブスクリプションも開始しました。

目次