Curso HTML 3.4 Comentarios en HTML

Comentarios en HTML

Los comentarios en HTML son bloques de texto que el navegador ignora al renderizar la página. Se usan para:

• Documentar secciones complejas del código.
• Desactivar temporalmente fragmentos de marcado.
• Incluir notas para otros desarrolladores.
• Insertar instrucciones de procesamiento para herramientas externas.

Sintaxis y reglas básicas

• Se escribe <!-- para abrir y --> para cerrar.
• No pueden anidarse directamente bloques comentados.
• No se permiten secuencias de dos guiones (--) dentro del contenido del comentario.
• La sintaxis proviene de SGML, predecesor de HTML.

Ejemplo básico

Este párrafo sí se mostrará.

Errores comunes y cómo evitarlos

Buenas prácticas

• Usar comentarios breves y claros.
• Evitar comentarios redundantes (no documentar lo obvio).
• Desactivar bloques de prueba durante el desarrollo.
• Eliminar comentarios que no aporten valor antes de poner en producción.

Comentarios condicionales para Internet Explorer

En versiones antiguas de IE era común usar condicionales:

Estos bloques solo se procesaban en IE y permitían cargar polyfills o hacks específicos.

Uso de comentarios en scripts y estilos

• JavaScript moderno no requiere comentarios HTML dentro de <script>, pero en HTML 3.2/3.4 se usaba:

• Para ocultar CSS de navegadores muy antiguos:

Casos de uso avanzados

1. Herramientas de preprocesado (p. ej. plantillas) usan comentarios para marcar zonas dinámicas.
2. Sistemas de internacionalización insertan tags especializadas dentro de comentarios.
3. Integración con generadores estáticos (Jekyll, Hugo) que usan comentarios para instrucciones de compilación.

Resumen

Los comentarios en HTML son indispensables para mantener el código claro y manejable. Aunque HTML5 permite más flexibilidad, conocer la sintaxis clásica de HTML 3.4 y sus limitaciones evita errores sutiles y garantiza compatibilidad con herramientas antiguas.