Para qué sirven los comentarios HTML y cómo insertarlos

Los comentarios HTML son textos que se añaden al código de una página web y que el navegador no ejecuta ni muestra a los usuarios. Sirven para documentar y explicar el código, y se escriben abriendo con los caracteres <!– y cerrando con –>. Todo lo que quede entre ambos se ignora al renderizar la página.

Qué son los comentarios HTML

Un comentario en HTML es un fragmento de texto que se introduce dentro del código de una página y que no es ejecutado por el navegador web ni resulta visible para quien la visita. Es decir, aunque forme parte del documento, no aparece en la pantalla cuando el usuario abre la web. Su finalidad es ayudar a las personas que trabajan con el código, no a quien navega por la página.

Los comentarios se utilizan para añadir explicaciones o referencias al código que faciliten comprender lo que realiza cada parte. En proyectos medianos o grandes, donde puede haber cientos de líneas, estas anotaciones resultan de gran ayuda para orientarse y recordar por qué se hizo algo de una forma determinada. Son, en cierto modo, las notas al margen que un programador deja para sí mismo y para el resto del equipo.

Para qué sirven los comentarios HTML

Aunque son invisibles para el visitante, los comentarios cumplen funciones muy útiles durante el desarrollo y el mantenimiento de una web:

• Documentar el código. Permiten dejar por escrito qué hace cada sección, algo que agradecerás cuando vuelvas a ese archivo pasado un tiempo.
• Organizar el documento. Sirven para marcar el inicio y el final de bloques (cabecera, menú, pie de página), de modo que sea más fácil localizarlos.
• Facilitar el trabajo en equipo. Cuando varias personas tocan el mismo código, los comentarios ayudan a entender las decisiones de los demás.
• Depurar y hacer pruebas. Permiten desactivar temporalmente una parte del código sin borrarla, simplemente convirtiéndola en comentario para comprobar cómo se comporta la página sin ella.

En definitiva, un código bien comentado es más fácil de mantener y de ampliar con el paso del tiempo. Cuando un proyecto crece o cambia de manos, esas anotaciones ahorran muchas horas de trabajo, porque evitan tener que descifrar desde cero qué hace cada parte del documento.

Cómo insertar comentarios en HTML

Crear un comentario es muy sencillo y solo requiere recordar la sintaxis de apertura y cierre. Estos son los pasos:

1. Selecciona el lugar del código donde quieres añadir el comentario, por ejemplo, justo después de una línea o de un bloque concreto.
2. Abre el comentario escribiendo el signo “menor que”, un signo de exclamación y dos guiones (<!–), escribe el texto que quieras y ciérralo con dos guiones y el símbolo “mayor que” (–>).

La estructura completa queda así: <!-- Esto es un comentario -->. Todo lo que escribas entre la apertura y el cierre será ignorado por el navegador, por lo que puedes usar el espacio para la anotación que necesites.

Ejemplos de comentarios en HTML

Un comentario puede servir para identificar una sección del documento, como en este caso: <!-- Tabla de valores estadísticos de ventas -->. También puedes usarlo para dejar una nota a tu equipo, por ejemplo <!-- Pendiente de revisar el enlace -->, o para “comentar” una línea de código que no quieres que se muestre de momento.

Comentarios de una o varias líneas

Los comentarios HTML pueden ocupar una sola línea o extenderse por varias, según lo que necesites explicar. Para un comentario breve basta con escribirlo entre la apertura y el cierre en la misma línea. Si la explicación es más larga, puedes abrir el comentario, escribir el texto en varias líneas y cerrarlo al final; el navegador seguirá ignorando todo el bloque por igual. Esta flexibilidad es muy útil para añadir descripciones detalladas o para desactivar fragmentos completos de código durante las pruebas.

Cómo ver los comentarios HTML

Como los comentarios no se muestran en la página, para verlos hay que acudir al código fuente. En la mayoría de navegadores puedes hacerlo pulsando la combinación de teclas para ver el código fuente (habitualmente Ctrl+U en Windows) o utilizando las herramientas de desarrollador, que se abren con la tecla F12 o haciendo clic derecho y eligiendo “Inspeccionar”. Ahí aparecerán los comentarios tal y como se escribieron.

Conviene tener presente este detalle: aunque el visitante medio no ve los comentarios, cualquiera que mire el código fuente sí puede leerlos. Por eso nunca se deben utilizar para guardar información sensible, como contraseñas, claves o datos privados.

Buenas prácticas con los comentarios

Los comentarios son útiles, pero conviene usarlos con criterio. Lo ideal es que aporten información que el código por sí solo no deja claro, sin caer en explicar lo evidente ni llenar el documento de anotaciones innecesarias. Un código bien comentado es más fácil de mantener, pero un exceso de comentarios puede dificultar su lectura. El equilibrio es la clave: claros, breves y en los puntos donde realmente ayudan.

Los comentarios viven dentro del código de tu web, y ese código necesita un lugar donde alojarse para estar disponible en internet. Para que tu página cargue con rapidez y se mantenga siempre accesible, conviene apoyarse en un alojamiento web rápido y estable que ofrezca un buen rendimiento tanto a los visitantes como a quien desarrolla y mantiene el sitio.

Preguntas frecuentes

¿Los comentarios HTML afectan al rendimiento de la web?

Su impacto es mínimo, pero no nulo: cada comentario ocupa unos bytes en el archivo. En páginas pequeñas es irrelevante, aunque en proyectos grandes es habitual eliminar los comentarios del código que se publica para que los archivos sean lo más ligeros posible.

¿Se pueden ver los comentarios HTML de cualquier web?

Sí. Al formar parte del código fuente, cualquier persona puede consultarlos abriendo el código de la página con Ctrl+U o con las herramientas de desarrollador. Por eso no deben usarse para almacenar información privada o confidencial.

¿Cuál es la diferencia entre un comentario HTML y uno de otros lenguajes?

La función es la misma —anotar el código—, pero la sintaxis cambia. En HTML se usan los caracteres <!– y –>, mientras que otros lenguajes como CSS o JavaScript emplean símbolos distintos para marcar sus comentarios.