Validación HTML: La declaración interna de codificación "utf-8" no coincide con la codificación real del documento ("windows-1252").

Acerca de este problema HTML

Cuando un navegador o validador lee tu documento HTML, busca la declaración <meta charset="..."> para determinar cómo decodificar los bytes del archivo. Cada codificación de caracteres mapea bytes a caracteres de manera diferente. UTF-8 y Windows-1252 comparten las mismas asignaciones para caracteres ASCII básicos (letras A–Z, dígitos, puntuación común), pero divergen para bytes en el rango 0x80–0x9F. Windows-1252 usa estos bytes para caracteres como €, ", ", —, y ™, mientras que UTF-8 los trata como inválidos o los interpreta como partes de secuencias multibyte. Cuando la codificación declarada no coincide con la codificación real, el validador muestra este error, y los navegadores pueden renderizar los caracteres incorrectamente.

Esto es un problema por varias razones:

Visualización de texto dañada: Caracteres como comillas curvadas (" "), guiones largos (—), y letras acentuadas (é, ñ) pueden aparecer como mojibake — secuencias como â€" o Ã© — confundiendo a tus lectores.
Cumplimiento de estándares: La especificación HTML requiere que la codificación declarada coincida con la codificación real de bytes del archivo. Una discrepancia es un error de conformidad.
Accesibilidad: Los lectores de pantalla y otras tecnologías de asistencia dependen de la interpretación correcta de caracteres. El texto ilegible es ininteligible para estas herramientas.
Motores de búsqueda: Las discrepancias de codificación pueden hacer que los motores de búsqueda indexen texto corrompido, perjudicando la capacidad de descubrimiento de tu contenido.

Cómo solucionarlo

El mejor enfoque es volver a guardar tu archivo en codificación UTF-8. La mayoría de editores de texto modernos e IDEs lo soportan:

VS Code: Haz clic en el indicador de codificación en la barra de estado inferior (puede decir “Windows 1252”), selecciona “Save with Encoding” y elige “UTF-8”.
Sublime Text: Ve a File → Save with Encoding → UTF-8.
Notepad++: Ve a Encoding → Convert to UTF-8, luego guarda el archivo.
Vim: Ejecuta :set fileencoding=utf-8 luego :w.

Después de volver a guardar, asegúrate de que tu declaración <meta charset="utf-8"> permanezca en el <head>. La etiqueta <meta charset> debería aparecer lo más temprano posible — idealmente como el primer elemento dentro de <head> — porque el navegador necesita conocer la codificación antes de analizar cualquier otro contenido.

Si tu flujo de trabajo o sistema heredado requiere absolutamente codificación Windows-1252, puedes cambiar la declaración a <meta charset="windows-1252"> en su lugar. Sin embargo, esto está fuertemente desaconsejado. UTF-8 es el estándar universal para la web, soporta virtualmente todos los caracteres de todos los idiomas, y es recomendado por la especificación HTML de WHATWG.

Ejemplos

Incorrecto — la discrepancia de codificación desencadena el error

El archivo está guardado en Windows-1252, pero la etiqueta meta declara UTF-8:

<!DOCTYPE html>
<html lang="en">
  <head>
    <meta charset="utf-8">
    <title>My Page</title>
  </head>
  <body>
<!-- El byte 0x93 en Windows-1252 representa " pero es inválido en UTF-8 -->

    <p>She said, "Hello!"</p>
  </body>
</html>

Esto produce el error del validador: La declaración interna de codificación “utf-8” no coincide con la codificación real del documento (“windows-1252”).

Correcto — archivo guardado como UTF-8 con declaración coincidente

Vuelve a guardar el archivo en codificación UTF-8. La etiqueta meta y la codificación de bytes del archivo ahora coinciden:

<!DOCTYPE html>
<html lang="en">
  <head>
    <meta charset="utf-8">
    <title>My Page</title>
  </head>
  <body>
    <p>She said, "Hello!"</p>
  </body>
</html>

Alternativa — declaración cambiada para coincidir con archivo Windows-1252

Si no puedes cambiar la codificación del archivo, actualiza la declaración charset para que coincida. Esto elimina el error de discrepancia pero no es el enfoque recomendado:

<!DOCTYPE html>
<html lang="en">
  <head>
    <meta charset="windows-1252">
    <title>My Page</title>
  </head>
  <body>
    <p>She said, "Hello!"</p>
  </body>
</html>

Consejos para prevenir este problema

Configura tu editor para que use UTF-8 por defecto para todos los archivos nuevos.
Si copias texto de Microsoft Word u otras aplicaciones de escritorio, ten en cuenta que a menudo usan comillas curvadas y caracteres especiales de Windows-1252. Pegar este texto en un archivo UTF-8 está bien mientras tu editor convierta correctamente los caracteres a bytes UTF-8 al guardar.
Usa <meta charset="utf-8"> como el primer elemento dentro de <head> para que la codificación se establezca antes de que el navegador encuentre cualquier otro contenido.
Si tu servidor envía un encabezado HTTP Content-Type con un parámetro charset, asegúrate de que también coincida — por ejemplo, Content-Type: text/html; charset=utf-8.