Caracteres especiales HTML: escapar, desescapar y tabla 1:1

Contenido
La escapada de caracteres especiales HTML consiste en convertir los cinco caracteres <, >, &, ", ' en códigos de entidad de carácter como < y &. El objetivo es que el navegador no los interprete por error como etiquetas o delimitadores de atributos y los muestre en pantalla como el texto que son.
Aquí abordamos el problema tanto de quien quiere mostrar ejemplos de código HTML tal cual en su blog como de quien, al contrario, necesita devolver a sus caracteres originales un código que ya está escapado.
Resumen ① Los cinco caracteres
&<>"'son los que el analizador HTML lee como delimitadores de etiquetas y atributos, y por eso generan conflictos. ② La escapada sustituye cada uno de esos cinco caracteres por el código&<>"'en una relación 1:1. ③ La desescapada hace lo contrario: devuelve los códigos a sus caracteres originales, y verificamos el resultado comprobando que no quede ningún rastro de la forma de código.
Por qué desaparecen o se rompen las etiquetas cuando publicas ejemplos de código
Si pegas código HTML tal cual, como <div class="box">, en una entrada de blog o en un foro, puede pasar que esos caracteres no se vean en pantalla y solo quede una caja vacía, o que se rompa el diseño.
La causa es que el navegador o el editor leen el texto pegado como marcado HTML real, no como un ejemplo de código. Cuando escribes <div>, el analizador interpreta «aquí empieza un elemento div», no «estas son las cuatro letras de div».
El mismo problema aparece en la dirección contraria. Si un texto que copiaste de algún sitio ya está escapado, como <div>, en pantalla no verás el código, sino literalmente los caracteres <div>. En este caso lo que hace falta es la operación inversa: desescapar para recuperar la etiqueta original.
Cómo convertir a mano sin herramientas: tabla de correspondencias y orden
Los caracteres que el analizador HTML lee de forma especial son exactamente cinco. Estas son las razones por las que cada uno resulta problemático y el código en el que se convierte.
| Carácter original | Qué lee el analizador | Código escapado |
|---|---|---|
& (ampersand) | Símbolo de inicio de una referencia de carácter (entidad) | & |
< (signo de menor que) | Símbolo de inicio de una etiqueta | < |
> (signo de mayor que) | Símbolo de cierre de una etiqueta | > |
" (comillas dobles) | Delimitador que encierra el valor de un atributo | " |
' (comilla simple) | Delimitador que encierra el valor de un atributo | ' |
Orden de sustitución: por qué hay que cambiar & primero
Cuando sustituyes estos cinco caracteres a mano, el orden importa: hay que empezar por &.
Si cambias < por < primero y después & por &, el & del < que acabas de crear también entra en la sustitución y obtienes un doble escapado como &lt;. Por eso el orden estándar es & → < → > → " → '.
El proceso completo con un ejemplo
Por ejemplo, si quieres convertir a mano <div class="box">A & B's</div>, primero cambias todos los & por &, luego los < y > por < y >, y por último las comillas dobles y la comilla simple por " y '.
El resultado es <div class="box">A & B's</div>.
Desescapar y verificar el resultado
El proceso inverso, la desescapada, va en la dirección contraria: basta con cambiar cada código de entidad por su carácter original, uno por uno.
Verificar el resultado es sencillo. Compara visualmente el texto devuelto para comprobar que no queda ni un solo carácter en forma de código como < > & " ' y que los caracteres < > & " ' que había antes han vuelto a aparecer intactos.
En lugar de sustituir carácter por carácter a mano, puedes pegar el texto en la herramienta de abajo y la misma conversión se hace en tiempo real. Compruébalo con nuestra herramienta.
Escribe en cualquiera de las dos casillas, la de la izquierda o la de la derecha, y el resultado convertido aparece al instante en la otra. Es gratis y no hace falta instalar nada ni iniciar sesión.

Puntos que suelen generar confusión
Si vuelves a escapar un texto que ya estaba escapado, los códigos se superponen. Por ejemplo, si pones en la casilla de entrada un texto ya convertido como <div>, el & que contiene se sustituye otra vez y obtienes &lt;div&gt;.
Lo primero que conviene comprobar es si el texto que vas a introducir es el original o código ya convertido.
La comilla simple puede aparecer con dos códigos distintos. Al escapar se genera el código numérico '. Al desescapar, en cambio, se reconocen como comilla simple tanto ' como el código con nombre '.
| Distinción | ' | ' |
|---|---|---|
| Se genera como resultado de la escapada | Sí | No |
| Se reconoce como comilla simple al desescapar | Sí | Sí |
Las entidades HTML y la codificación URL son sistemas distintos. Si conviertes < a una entidad HTML obtienes <, pero si lo conviertes con codificación URL obtienes %3C. Son reglas de conversión diferentes que se aplican en lugares distintos (el cuerpo del documento frente a una cadena de URL) y no se pueden intercambiar.
En resumen
- Solo los cinco caracteres
&<>"'entran en conflicto con el analizador HTML y son objeto de escapada. El resto de caracteres no cambia. - Cada carácter se sustituye 1:1 por
&<>"'. - Al sustituir a mano, cambia
&primero para evitar el doble escapado. - Para verificar el resultado devuelto, comprueba que no queden caracteres en forma de código.
- Al desescapar se reconoce como comilla simple tanto
'como'.
Escribe en cualquiera de las dos casillas, la de la izquierda o la de la derecha, y el resultado convertido aparece al instante en la otra. Es gratis y no hace falta instalar nada ni iniciar sesión.
Preguntas frecuentes
¿Por qué hay que cambiar & antes que nada?
Si cambias primero otros caracteres como < o ", el & de los < y " que se acaban de generar vuelve a entrar en la sustitución. Así obtienes un resultado con códigos superpuestos, como &lt;. Si cambias & primero, este problema no ocurre.
¿' y ' son lo mismo?
Los dos son códigos que representan la comilla simple ('). Al escapar se genera el código numérico '. ' es un código con nombre: no se genera directamente como resultado de la escapada, pero al desescapar se reconoce como comilla simple igual que '.
¿Escapar y codificar en URL son lo mismo?
No. La escapada HTML convierte < en un código de entidad de carácter como <, y la codificación URL convierte ese mismo carácter en un código de porcentaje como %3C. Los dos sistemas se usan en lugares distintos y sus reglas de conversión no son compatibles entre sí.
Si desescapo, ¿queda exactamente igual que el original?
Para los cinco caracteres que se modifican al escapar (& < > " '), vuelves exactamente a los caracteres originales.
Eso sí, esta conversión solo trabaja con los códigos de entidad relacionados con esos cinco caracteres. Si el original ya contenía desde el principio otro tipo de entidades (por ejemplo, un código que representa un espacio), esa parte no entra en esta conversión.
Este artículo está adaptado de nuestro original en coreano. Leer el original en coreano