HTML: Comentários HTML
Comentários são anotações de texto escritas para os desenvolvedores. Os navegadores os ignoram completamente. Usar comentários de forma inteligente pode melhorar drasticamente a legibilidade do código e facilitar a colaboração em equipe.
1. Sintaxe de Comentários
Os comentários HTML começam com <!-- e terminam com -->. O conteúdo entre eles pode ser qualquer texto; o navegador não o exibirá na página:
▶ Exemplo
HTML
<!-- Este é um comentário, os usuários não podem me ver -->
<p>Este texto é visível para os usuários.</p>
<!-- ======= Início da Seção de Navegação ======= -->
<nav>
<a href="index.html">Início</a>
<a href="about.html">Sobre Nós</a>
</nav>
<!-- ======= Fim da Seção de Navegação ======= -->
📌 Nota: Embora o conteúdo dos comentários não seja visível na página, ele ainda aparece no código-fonte HTML — qualquer pessoa pode ver seus comentários ao visualizar o código-fonte da página. Nunca inclua senhas ou informações confidenciais nos comentários.
2. Usos Comuns dos Comentários
Comentários não servem apenas para escrever anotações — eles também são muito úteis durante o desenvolvimento e a depuração:
▶ Exemplo
HTML
<!-- Comentar temporariamente um trecho de código (para depuração) -->
<!--
<p>Este código não precisa ser exibido por enquanto.</p>
<a href="pagina-antiga.html">Link Antigo</a>
-->
<!-- TODO: Preciso adicionar o avatar do usuário mais tarde -->
<!-- @João 2026-06-12: Confirmar o texto aqui antes de publicar -->
💡 Boa Prática: Os comentários devem explicar o porquê de algo estar escrito de certa forma, e não como está escrito. Um bom código deve ser autoexplicativo; os comentários apenas complementam o contexto que o próprio código não consegue expressar. Além disso, lembre-se de limpar os comentários de depuração antes de publicar o site.
❓ Perguntas Frequentes
P Os usuários podem ver os comentários HTML?
R Os comentários não aparecem na página, mas qualquer pessoa pode vê-los ao visualizar o código-fonte (clique direito → Ver código-fonte). Portanto, nunca coloque senhas, chaves de API ou lógica confidencial nos comentários. Comentários são para desenvolvedores, não para usuários. Limpe os comentários de depuração antes de publicar.
P Comentários podem ser aninhados?
R Não. Comentários HTML não suportam aninhamento — você não pode escrever
<!-- --> dentro de outro comentário. Se tentar, o navegador trata o primeiro --> como o fim do comentário, expondo todo o conteúdo após ele na página. Se precisar comentar um bloco que já contém comentários, considere usar CSS display:none ou JavaScript para controlar a visibilidade.P O que posso colocar dentro de comentários?
R Comentários podem conter qualquer texto, quebras de linha e espaços, mas não podem conter
-- (hífen duplo) pois pode ser interpretado como o fim do comentário. Usos comuns：1）Marcadores de seção (como <!-- Início da Navegação -->); 2）Marcadores TODO (como <!-- TODO: Adicionar busca -->); 3）Ocultação temporária de código (para depuração); 4）Informações do autor (como <!-- @João 2026-06-12 -->).📖 Resumo
- Comentários começam com
<!--e terminam com-->; os navegadores não os exibem - Comentários podem ser usados para explicar blocos de código, ocultar código temporariamente e adicionar marcadores TODO
- Informações confidenciais nos comentários são visíveis para todos — nunca coloque senhas ali
- Limpe os comentários de depuração antes da publicação para manter o código-fonte organizado
📝 Exercícios
- Adicione comentários ao seu código: Escreva uma página simples com navegação e conteúdo principal, adicionando marcadores de comentário antes e depois de cada bloco (por exemplo,
<!-- Início da Navegação -->). - Depuração com comentários: Copie o código de uma lição anterior e use comentários para "ocultar" temporariamente uma seção. Verifique se a seção oculta realmente não é exibida na página.
