開發工具

HTML 轉義與還原

在瀏覽器內轉義五種 HTML 特殊字元,或還原具名及數值字元參照。適用於一般 HTML 文字及以引號包住的一般屬性值,並非 HTML 淨化工具。

關於HTML 轉義與還原

將 HTML 標記轉成可顯示的文字

貼上文字後選擇「轉義」,即可把五種特殊字元轉成 HTML 字元參照:& 變成 &amp;、< 變成 &lt;、> 變成 &gt;、雙引號 " 變成 &quot;,單引號 ' 則變成 &#39;。

例如 <p title="香港 & 九龍">香港,你好!</p> 會轉成 &lt;p title=&quot;香港 &amp; 九龍&quot;&gt;香港,你好!&lt;/p&gt;,讓標記以文字方式呈現。已轉義的內容再次轉義,會多一層編碼,例如 &lt; 會變成 &amp;lt;。如所用框架已自動處理文字轉義,請避免重複編碼。

還原具名及數值字元參照

「還原」支援 2,125 種具名 HTML 字元參照,以及十進制和十六進制數值字元參照。每個參照均須以分號結尾,名稱區分大小寫。不明名稱及沒有分號的內容會原樣保留。例如 香港 &amp; 九龍 &#x1F9EA; 會變成 香港 & 九龍 🧪。

工具每次只還原一層:&amp;lt; 會變成 &lt;,不會直接變成小於符號。數值為 0、代理碼元或大於 U+10FFFF 時,會以 U+FFFD 替代。部分控制字元數值按 HTML 標準對應,例如 &#128; 會變成歐元符號。這是文字轉換工具,並非完整的 HTML 解析器;規則不等同瀏覽器解析整份 HTML 文件。

轉義的適用範圍及安全限制

轉義結果適用於一般 HTML 文字內容,以及以單引號或雙引號包住的一般屬性值。元素及屬性名稱應由程式固定設定並保持可信。JavaScript、CSS、網址、事件屬性、沒有引號的屬性值及其他 HTML 語境,需要相應的驗證與編碼,不能單靠本工具處理。

本工具不會移除危險標籤,也不是 HTML 淨化工具。例如 javascript:alert(1) 經過 HTML 轉義後,仍不能當作安全連結使用。還原後的文字可能包含可執行標記,請勿直接當作安全 HTML 插入網頁。本頁只會在文字欄內顯示結果。

輸入上限、複製、下載及私隱

轉義輸入最多 100,000 個 UTF-16 碼元;還原輸入及結果最多 600,000 個。這並非位元組數,也不等同畫面上的字數。Unicode 輔助平面字元佔 2 個碼元,組合 emoji 可能更多。未配對的代理碼元會被拒絕。切換模式會保留輸入內容;「將結果移至輸入欄並反向轉換」會以目前結果取代輸入並切換方向。若結果超出下一個模式的輸入上限,便不能執行此操作。

可直接複製、選取結果後手動複製,或下載 UTF-8 文字檔。剪貼簿操作可能延遲,尚未完成前請避免其他複製操作。下載會保留結果的換行碼及開頭的 U+FEFF;畫面顯示或貼上目的地則可能將換行轉成 LF 或 CRLF。「已開始下載」只表示已向瀏覽器提出下載要求,並不代表已確認檔案儲存完成。

轉換在瀏覽器內進行,不會將輸入或結果上載至伺服器。網站仍會發出一般頁面及分析請求。這不保證瀏覽器擴充功能、共用裝置或剪貼簿的安全,請小心處理機密內容。

常見問題

Q. 轉義與還原有甚麼分別?
轉義會把 &、<、>、雙引號及單引號轉成 HTML 字元參照。還原則以單次轉換復原支援的參照,例如「香港 &amp; 九龍」會變成「香港 & 九龍」。
Q. 轉義後的 HTML 一定安全嗎?
不是。工具適用於一般 HTML 文字及以引號包住的一般屬性值,並非 HTML 淨化工具。JavaScript、CSS、網址、事件屬性及沒有引號的屬性值仍需相應處理。還原結果亦不能直接視為安全 HTML。
Q. 為何 &amp;lt; 不會一次還原成小於符號?
每次只還原一層。&amp;lt; 會先變成 &lt;,再次還原才會得到 <。工具不會未經操作便遞迴還原多層內容。
Q. 字元參照一定要以分號結尾嗎?
是。工具支援 2,125 種區分大小寫的具名參照,以及十進制和十六進制數值參照,均須有結尾分號。不明名稱會保留。這與完整 HTML 文件的解析規則不同。
Q. 最多可以輸入多少文字?
轉義輸入上限為 100,000 個 UTF-16 碼元;還原輸入及結果上限為 600,000 個。輔助平面字元佔 2 個碼元,組合 emoji 可能更多。未配對的代理碼元會被拒絕。
Q. 下載會保留原有的換行嗎?
UTF-8 下載會保留結果中的換行碼及開頭的 U+FEFF;顯示或貼上時則可能正規化換行。還原本身會按規則改變字元,因此不能把它視為任意原始檔案的逐位元組還原工具。
Q. 輸入內容會上載到伺服器嗎?
不會。轉換在瀏覽器內完成,不會上載輸入或結果;網站仍有一般頁面及分析請求。剪貼簿操作及下載檔案由瀏覽器和裝置處理。

資料來源與規格

相關工具

有問題或建議? 聯絡 NanToo

為這項工具評分
—(0 則評分)