100 % privado — todo se ejecuta en tu navegador
Comentario Markdown
Escribe <!-- una nota --> en tu Markdown y se queda en la fuente pero desaparece de la página. Editar ejemplos de comentario Markdown ocultos, en vivo.
Equipo de MD Viewer
Visible text
Un comentario Markdown es un comentario HTML con otro propósito: escribes <!-- tu nota --> en la fuente y los renderizadores la ocultan de la página final manteniéndola en el archivo. El patio de juego de arriba muestra las dos mitades de ese comportamiento lado a lado — el panel de origen contiene el comentario Markdown, el panel de vista previa no. Edita el texto entre los marcadores y mira cómo cambia la nota oculta sin aparecer jamás en el resultado renderizado.
Se usa un comentario Markdown para lo que un archivo necesita pero una página no debe mostrar: notas de revisión, TODOs, instrucciones para futuros editores, secciones comentadas durante una reescritura o recordatorios de qué campos acepta una plantilla. Como el comentario Markdown es texto plano en el archivo, sobrevive al control de versiones, los diffs, grep y la búsqueda — es una nota para colaboradores, no para el renderizador.
Dos avisos honestos acompañan la técnica. Primero, un comentario Markdown no es privado: cualquiera que abra el archivo crudo o vea el código fuente de la página lo verá — nunca metas secretos, credenciales o anuncios sin publicar. Segundo, los renderizadores que eliminan todo el HTML eliminarán también el comentario — inofensivo, pero la nota desaparece antes de lo esperado. Los ejemplos cubren las formas de bloque y en línea.
Referencia de sintaxis del comentario Markdown
| Escribes | Qué ocurre |
|---|---|
| <!-- nota --> | Un comentario Markdown en su propia línea — oculto en la vista previa |
| Texto <!-- nota --> texto | Un comentario en línea oculto entre palabras visibles |
| <!-- línea uno línea dos --> | Un comentario multilínea en la fuente |
| <!-- **borrador** --> | El formato dentro del comentario también queda oculto |
| <!-- (sin marcador de cierre) | Comentario roto — el resto del archivo puede desaparecer |
Cómo escribir un comentario Markdown
- 1
Abre con <!--
Coloca el marcador de apertura donde empiece el contenido oculto — al inicio de una línea para un comentario Markdown en bloque, o en plena frase para una nota en línea.
- 2
Escribe tu nota
Todo lo que quede entre los marcadores pertenece al comentario Markdown: texto plano, formato Markdown, incluso párrafos de borrador. Nada se renderiza.
- 3
Cierra con -->
El marcador de cierre es obligatorio. Un comentario Markdown sin terminar se traga todos los caracteres posteriores — la forma más común de romper una página con comentarios.
- 4
Comprueba la vista previa
El panel de origen mantiene tu nota visible; la vista previa la muestra desaparecida. Esa vista dividida es exactamente cómo se comporta un comentario Markdown en las cadenas reales de documentación.
Para qué sirve un comentario Markdown
El uso más fuerte del comentario Markdown es editorial: dejar instrucciones donde se necesitan. Una plantilla puede llevar <!-- Rellena la clave de API abajo --> sobre cada sección; un registro de cambios guarda <!-- entrada redactada, pendiente de revisión legal --> junto a un punto sin publicar; un README largo comenta una sección obsoleta en vez de borrar el historial. El texto se queda en el archivo: git blame lo atribuye y los futuros editores solo borran los marcadores para restaurar el contenido.
La segunda familia de usos es estructural. Comentar un bloque de código defectuoso mientras depuras documentación, ocultar una tabla borrador hasta confirmar cifras o marcar dónde se insertará una tabla de contenidos generada — todas son tareas naturales del comentario Markdown. Lo que un comentario nunca debe ser es un mecanismo de seguridad: el contenido viaja dentro del archivo público, así que trata cada comentario Markdown como texto publicado con la cortesía de no renderizarse.
En un repositorio compartido, un comentario Markdown es un mensaje para el próximo editor: ponle fecha, iniciales y di qué debe pasar. <!-- TODO(ana): confirmar el precio antes del lanzamiento Q3 --> vive un año más que <!-- revisar esto -->. ¿Tarea hecha? Borra el comentario Markdown entero en lugar de convertirlo en lápida: el historial pertenece al control de versiones, no a los sedimentos de comentarios.
Errores del comentario Markdown
<!-- nota sin cerrar
<!-- nota cerrada -->
Un comentario que no se cierra oculta todo lo que viene después — a veces el resto entero del archivo. Cierra siempre el comentario Markdown.
<!--> marcador traicionero -->
<!-- nota simple -->
Poner > justo después de <!-- cierra el comentario al instante y filtra el resto como texto visible. Deja un espacio tras el marcador de apertura.
Guardar claves API en comentarios
Nunca meter secretos en Markdown
Un comentario Markdown lo ve cualquiera que lea el archivo crudo. No lo trates nunca como cifrado ni control de acceso.
Los comentarios se quedan en tu archivo descargado
Copiar o descargar desde esta página preserva el comentario Markdown byte a byte. Solo el renderizado lo oculta: el archivo que guardas es idéntico al que abriste.
Comentario Markdown en generadores y temas
Una mirada más allá del horizonte: algunos generadores de sitios estáticos interpretan formatos especiales de comentario como instrucciones de compilación — por ejemplo <!-- more --> como marca de corte para el resumen. En ese contexto un comentario Markdown no es texto muerto sino configuración activa. Si usas plantillas o temas ajenos, revisa su documentación antes de borrar o añadir comentarios a ciegas.
Y un detalle de editor: muchos editores modernos resaltan los comentarios HTML en gris en cuanto los detectan — un aviso bienvenido de que ahí hay texto invisible. No te fíes de ello como regla: en texto plano, el comentario Markdown sigue visible para cualquiera que abra el archivo.
Preguntas frecuentes
Fuentes y citas de especificación
“Comments must start with the four character sequence U+003C LESS-THAN SIGN, U+0021 EXCLAMATION MARK, U+002D HYPHEN-MINUS, U+002D HYPHEN-MINUS (<!--).”
“Raw HTML (and thus, HTML comments) is passed through unaltered — but the rendered output is the browser’s decision.”