O validador de marcação W3C
Encontre e corrija erros de HTML com o Serviço de Validação de Marcação W3C.
O validador de marcação W3C é uma aula grátis de HTML Academy no CoddyKit. Esta é a aula 1 de 4. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de HTML Academy, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de HTML Academy inclui 4 aulas no total.
O que o validador verifica
O Validador de marcação do W3C (validator.w3.org) analisa HTML com base na especificação oficial e informa cada violação da especificação: etiquetas não fechadas, aninhamento inválido (um <p> dentro de outro <p>), atributos obrigatórios ausentes (img sem alt), elementos não reconhecidos e muitos outros problemas.
Por que a validação é importante
Um HTML inválido pode ser renderizado em qualquer navegador hoje, mas cada navegador pode corrigir os erros de forma diferente — o que parece correto no Chrome pode falhar no Firefox. Um HTML válido produz uma renderização previsível e consistente e evita comportamentos inesperados em leitores de tela, rastreadores de busca e clientes de e-mail.
Três formas de enviar
Valide por URL (cole a URL da página), enviando um arquivo ou por entrada direta (cole o HTML). A URL é melhor para páginas em produção; a entrada direta é útil durante o desenvolvimento, quando o arquivo ainda não está disponível em nenhum lugar.
Leitura dos resultados
Os erros apresentam um número de linha, um trecho da marcação problemática e uma explicação. Corrija de cima para baixo — muitos erros são consequências em cascata de um único erro anterior. Depois de corrigir os primeiros, execute novamente para verificar quantos avisos restantes são legítimos.
Avisos e erros
Erros são violações da especificação que podem interromper a renderização. Avisos são padrões suspeitos que são tecnicamente válidos, mas provavelmente não foram intencionais (nomes de atributos com aparência de erro de digitação, indicações de acessibilidade). Trate os erros como correções obrigatórias e os avisos como pontos que merecem investigação.
Erros comuns
Atributo alt ausente em img. Tag de fechamento automático não fechada (<br> em vez da forma legada <br/>, que também é válida). ID duplicado na página. Rótulo de formulário sem um atributo for correspondente a um ID de input. Elementos interativos aninhados (um botão dentro de um a). Esses cinco problemas respondem pela maior parte da saída do validador.
Validando modelos
Se o seu HTML for gerado por modelos, valide a saída final (a página renderizada), e não o código-fonte do modelo. Um marcador {{ }} não é HTML válido — somente o que o mecanismo produz importa. Execute o validador na CI contra páginas renderizadas a partir de uma compilação de teste.
CLI do html-validate
Para integrar à CI, use o pacote npm html-validate: npx html-validate "public/**/*.html" valida todas as páginas de uma compilação. Configure as regras em .htmlvalidate.json. Use isso para fazer as compilações falharem quando houver regressões na validação.
Stylelint e análise estática na origem
A análise estática no momento da escrita (stylelint para CSS, eslint-plugin-jsx-a11y para React) detecta muitos problemas antes que eles cheguem ao validador. Combine-a com a validação de ponta a ponta na CI para obter uma defesa em camadas — detecte a maioria dos problemas cedo e o restante antes da implantação.
O que a validação NOT captura
A validação verifica a correção da marcação, não a semântica. Uma página com todos os títulos como <h6> é HTML válido, mas tem semântica ruim. As auditorias de acessibilidade do Lighthouse e a revisão manual detectam problemas semânticos que o validador não detecta.
Aviso sobre o modo Quirks
A ausência de <!doctype html> ativa o modo Quirks — os navegadores usam uma camada legada de compatibilidade que quebra o CSS moderno. O validador sinaliza a ausência do doctype como o primeiro erro; nunca implante uma página sem a declaração do doctype.
Validação contínua
Execute a validação em cada PR por meio do GitHub Actions: instale html-validate, execute-o no site compilado e faça o PR falhar se houver erros. Erros novos são detectados no momento da revisão, em vez de se acumularem durante meses e se tornarem difíceis de corrigir posteriormente.
Verificação de conhecimento
Por que a ausência da declaração <!doctype html> é tão importante para o validador W3C?
Resumo
O W3C Markup Validator analisa o HTML de acordo com a especificação e relata marcação inválida. Use-o pela interface web para verificações pontuais e pela CLI do html-validate na CI para obter cobertura contínua. Problemas comuns: alt ausente, IDs duplicados, doctype ausente e elementos interativos aninhados. A validação detecta erros de marcação; combine-a com o Lighthouse e a revisão manual para garantir qualidade semântica e de acessibilidade.
Perguntas Frequentes
A aula “O validador de marcação W3C” é grátis?
Sim — o texto completo de “O validador de marcação W3C” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de HTML Academy, atualize para CoddyKit PRO. O curso de HTML Academy inclui 4 aulas no total.
O que vou aprender em “O validador de marcação W3C”?
Encontre e corrija erros de HTML com o Serviço de Validação de Marcação W3C. Você pratica HTML Academy com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.
Preciso ter experiência prévia para começar HTML Academy?
Nenhuma experiência prévia é necessária. HTML Academy no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 1 de 4.
Quanto tempo leva a aula “O validador de marcação W3C”?
A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.
Posso escrever e executar código nesta aula de HTML Academy?
Sim. Cada aula de HTML Academy inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.
Todas as aulas deste curso
- O validador de marcação W3C
- Auditoria de HTML com Lighthouse
- Pa11y e axe para testes de acessibilidade
- Testes de instantâneos de HTML