Codificador y decodificador de entidades HTML con nombre

Convierta texto a entidades HTML con nombre y viceversa sin instalar paquetes ni depender del DOM de un navegador. El modo de codificación protege caracteres sensibles del marcado, como ampersands, corchetes angulares, comillas y apóstrofos, además de varios símbolos y signos tipográficos habituales. El modo de decodificación restituye las entidades reconocidas y rechaza los nombres desconocidos, en vez de ocultar un posible error.

Codifique el texto antes de insertarlo en HTML

Utilice el modo de codificación cuando necesite representar texto sin formato de manera segura dentro del código HTML. Un ampersand puede iniciar una referencia de entidad, los corchetes angulares pueden interpretarse como etiquetas y las comillas pueden interferir con la sintaxis que rodea al valor. El conversor sustituye los caracteres compatibles por referencias con nombre como <code>&amp;amp;</code>, <code>&amp;lt;</code>, <code>&amp;gt;</code>, <code>&amp;quot;</code> y <code>&amp;apos;</code>.

También reconoce caracteres frecuentes de moneda, propiedad intelectual, matemáticas, puntuación y espaciado: copyright, marca registrada, euro, espacio de no separación, rayas, comillas curvas, viñetas y puntos suspensivos. La codificación se realiza en una sola pasada, por lo que los ampersands introducidos durante el proceso no vuelven a codificarse. Las letras, los números, los espacios, los emoji y los caracteres no incluidos permanecen intactos.

Tenga presente que esta operación representa texto, pero no sustituye a un sanitizador HTML: no valida documentos, no elimina etiquetas peligrosas ni determina si un valor es seguro en contextos JavaScript, CSS o URL.

Decodifique entidades con una validación estricta

Elija el modo de decodificación cuando el texto contenga referencias con nombre y necesite recuperar los caracteres originales para mostrarlos, compararlos, indexarlos, exportarlos o procesarlos. Cada referencia completa formada por un ampersand, un nombre y un punto y coma se consulta en la tabla fija de la capacidad. Las referencias conocidas se sustituyen por sus caracteres Unicode, sin alterar el resto de la cadena.

Los nombres distinguen entre mayúsculas y minúsculas, pues en HTML una capitalización diferente puede tener otro significado. Este rechazo estricto ayuda en procesos automatizados: un error como <code>&amp;copry;</code> no se conserva silenciosamente para aparecer más tarde como texto defectuoso. Un ampersand aislado, sin un nombre y punto y coma que formen una entidad, se mantiene sin cambios.

La capacidad se limita expresamente a entidades con nombre; las referencias numéricas decimales o hexadecimales quedan fuera del contrato. Como el mapa siempre es el mismo, el resultado no depende del navegador, de paquetes externos, de la red ni de la configuración regional.

Seleccione el modo e integre el resultado

Envíe dos campos: <code>text</code> contiene la cadena de origen y <code>mode</code> debe ser <code>encode</code> o <code>decode</code>. Ambos son obligatorios para que ninguna integración tenga que adivinar el sentido de la conversión. La respuesta incluye el <code>text</code> convertido y el <code>mode</code> aplicado, de modo que los registros y flujos de trabajo se expliquen por sí mismos.

En un proceso de codificación, pase el contenido escrito por personas antes de insertarlo en marcado y almacene o transmita el resultado. En uno de decodificación, trate cualquier entidad desconocida como un fallo de validación y corrija al productor en lugar de ignorarlo. El algoritmo no usa red, azar, fechas ni estado persistente, por lo que sirve para pruebas de referencia y generación reproducible.

En sistemas grandes, establezca un límite claro: codifique al entrar en una representación HTML y decodifique únicamente al salir de ella. Alternar los modos repetidamente dificulta saber quién controla el escapado y favorece la doble codificación accidental.