HTMLエンティティコンバーター

HTMLエンティティコンバーターは、Webページやコンテンツ管理システムなどのテキスト形式で使うHTML文字参照と、デコード後の文字を相互に変換できる無料ツールです。

HTMLエンティティとは何ですか？ なぜ必要なのですか？

HTMLエンティティは、HTMLのマークアップと区別できるテキストで文字を表します。HTML文字参照は通常、アンパサンドで始まり、セミコロンで終わります。アンパサンドを表す&のような名前付き文字参照と、ポンド記号を表す£のような数値文字参照があります。

HTMLで特別な意味を持つ文字を記述するときに役立ちます。例えば、小なり記号をそのまま書くとタグの開始と解釈される可能性があるため、<と記述できます。文字参照を使えば、マークアップや制御構文と混同させずに、HTMLや互換性のあるマークアップで特定の文字を表現できます。

エンティティへの変換は暗号化ではなく、機密性もありません。誰でも文字参照を読んだりデコードしたりできるため、パスワード、個人データ、機密情報を隠す目的には絶対に使用しないでください。

HTMLエンティティを変換するには？

エンコードまたはデコードと表示された欄に対象のテキストを入力し、対応するHTMLエンティティのエンコード結果またはHTMLエンティティのデコード結果を確認してください。該当するHTMLのテキストや属性のコンテキストに文字列を配置する場合はエンコード結果を使います。既存のエンティティが表す文字を取り出したい場合は、デコード結果を使ってください。

変換処理はサーバー上で実行されます。入力内容はHTTPS経由でサーバーへ送信され、保存されません。

変換する前に、本当にHTMLエンティティが必要か確認してください。クエリ文字列の値には通常、代わりにURLのパーセントエンコーディングが必要です。一方、国際化ドメインにはPunycodeを使います。それぞれの形式にはURLデコーダーとIDN Punycode コンバーターを使用してください。

エンコード結果とデコード結果はどうなりますか？

デコードすると、認識された文字参照が対応する文字に置き換わります。エンコードすると、文字がエンティティ構文で表されます。

入力: <p>Tea & cake</p>

デコード結果: <p>Tea & cake</p>

デコード結果に含まれる山括弧は文字ですが、HTMLとしてページに挿入するとマークアップになる可能性があります。デコードしても、コンテンツのサニタイズ、スクリプトの除去、信頼できないHTMLの安全化は行われません。デコードした内容は、実際に使用するコンテキストに応じて扱ってください。

具体例と扱いにくい入力

名前付きエンティティと数値文字参照は、同じ文字を異なる方法で表せます。例えば、&amp;はアンパサンドを表す名前付き文字参照です。&#38;は10進数による数値文字参照、&#x26;は16進数による表記です。

• 通常の空白や数字そのものは文字参照ではないため、一般にはそのままのテキストとして残ります。
• 句読点や記号が変換されるのは、認識可能な文字参照として書かれている場合か、意図的にエンコードした場合だけです。
• アクセント付き文字、非ラテン文字、絵文字は、UnicodeコードポイントをHTMLソースの文字エンコーディングとは独立して指定する数値文字参照で表せます。正しく表示できるかどうかはフォントの対応状況に左右されます。また、デコード結果を保存または転送する場合は、文字エンコーディングも重要です。

エンティティを記述するときは、末尾のセミコロンを含めてください。ブラウザーは一部の限られたコンテキストでセミコロンのない文字参照を許容しますが、この省略形は曖昧になりやすく、パーサー間の互換性も低くなります。

HTMLエンティティはどこで使われていますか？

HTMLエンティティは、HTMLソース、コンテンツ管理システム、リッチテキストエディター、HTMLメールなどでよく使われます。例えば、WordPressのコード表示では、改行されない空白を表す&nbsp;や、マークアップ内でアンパサンドを保持するための&amp;が含まれることがあります。

別の形式で運ばれるデータの中にHTMLエンティティが現れる場合もあります。この場合はエンコードが複数の層に分かれているため、正しい順序で処理しなければなりません。

• JSONペイロードにHTML断片が含まれ、そのテキスト内にエンティティが使われている場合があります。JSONのエスケープ処理とHTMLエンティティのデコードは別の操作です。
• クエリ文字列に、パーセントエンコードされたHTMLが含まれる場合があります。まずURLの層をデコードし、その結果にもエンティティが含まれているか判断してください。
• データURIには、エンティティを含むHTMLなどのテキストを格納できます。ただし、URI自体にはパーセントエンコーディングやBase64が使われている場合があります。
• HTMLメールでは、表示される句読点や記号がエンティティ化され、転送にはMIME転送エンコーディングが使われている場合があります。
• 国際化ドメインがエンティティ化されたHTMLと並んで現れることもありますが、ドメイン自体は通常、HTMLエンティティではなくPunycodeで表します。

HTMLエンティティをデコードできない、または文字化けするのはなぜですか？

多くの場合、入力の形式が壊れている、別のエンコード方式が使われている、またはエンコードが複数の層に分かれていることが原因です。結果を確認せずに変換を繰り返すのではなく、元のテキストに名前付きまたは数値形式のHTML文字参照が含まれているか調べてください。

• 不正な文字参照: アンパサンド、番号記号、セミコロンのいずれかが欠けると認識されない場合があります。&amp;や&#38;などの形式と見比べてください。
• 二重にエンコードされた入力: &amp;lt;のようなテキストは、1回デコードすると&lt;になります。小なり記号にするには、意図的にもう一度デコードする必要があります。
• 文字セットの不一致: 誤った文字エンコーディングで解釈すると、置換文字が表示されたり、アクセント付き文字が壊れたりすることがあります。
• 形式が違う: パーセント記号を含むテキストは、URLエンコードされている可能性があります。英字、数字、プラス記号、スラッシュ、末尾の等号からなる長い文字列は、Base64かもしれません。
• Base64入力で、種類またはアルファベットが違う: URLセーフBase64では、標準Base64とは異なる文字を使用します。パディングがないと、一部のデコーダーで処理できない場合もあります。これらはHTMLエンティティ構文の問題ではないため、Base64デコーダーを使用してください。

よくある質問

&nbsp;が普通の空白に見えるのはなぜですか？

&nbsp;は改行されない空白を表します。通常の空白とほぼ同じ見た目ですが、その位置では改行されません。エディター上では見えないまま保持されることがあるため、空白の問題を調べるときはソース表示に切り替えるか、その文字の種類やコードを確認してください。

HTMLエンティティ名は大文字と小文字を区別しますか？

はい。名前付き文字参照には定められた綴りがあり、大文字と小文字の違いによって認識されなくなることがあります。ブラウザーのエラー修復に頼らず、公開されている正確な名前を使い、末尾のセミコロンも含めてください。

アクセント付き文字はすべてエンティティにする必要がありますか？

いいえ。UTF-8が正しく宣言されたHTML文書には、é、£、中文などの文字を直接記述できます。マークアップ構文、古いシステム、特定の公開ルールで必要とされる場合は、エンティティが引き続き役立ちます。

HTMLエンティティはXMLでも使えますか？

XMLであらかじめ定義されている名前付きエンティティは、&amp;、&lt;、&gt;、&quot;、&apos;など少数に限られます。HTMLでは有効でも、文書型で定義されていなければXMLでは無効になる名前が数多くあります。そのため、数値文字参照を使うほうが安全な場合がよくあります。

エンティティコンバーターで壊れたHTMLを修復できますか？

いいえ。文字参照は変換できますが、タグの対応を整えたり、入れ子を修正したり、文書を検証したりはしません。変換後もページが想定どおりに動作しない場合は、周囲のマークアップを確認し、HTMLバリデーターを使用してください。

最後に確認すること

変換元でHTMLの名前付き文字参照と数値文字参照のどちらが使われているかを確認し、必要な文字参照の層だけを変換してください。そのうえで、意図した表示テキストと結果を比較します。デコードした内容を公開中のページに配置する前に、変換後の山括弧、引用符、アンパサンドが実際のHTMLコンテキストでどう解釈されるか確認してください。