comentario rebajado

Markdown es uno de los lenguajes de marcado más populares del mundo. Desarrollado por John Gruber en 2004, Markdown es un lenguaje de marcado simple y liviano que le permite agregar elementos de formato al texto sin formato. Markdown es independiente de la plataforma y se puede transportar en prácticamente cualquier aplicación. Como resultado, ha ganado un amplio uso en el desarrollo web como blogs, documentos, cuadernos, correos electrónicos, etc.

¿Cómo funciona Markdown?

Como se mencionó anteriormente, Markdown es un lenguaje de marcado. Por lo tanto, está trabajando en un archivo con la extensión .md o .markdown. Este archivo contiene elementos de formato como encabezados, bloques de código, sangría, alineación, etc. El documento Markdown es procesado por una aplicación conocida como procesador o analizador Markdown. Luego, el analizador toma el texto formateado y genera el documento HTML. A continuación, puede ver el documento HTML en un navegador o en cualquier aplicación que lo admita. La siguiente imagen muestra cómo funciona este proceso.

(Esta imagen es de la Guía de Markdown). Para obtener más información sobre cómo funciona Markdown, consulte el siguiente recurso: https://www.markdownguide.org/

¿Qué es un comentario de descuento?

Un comentario de descuento hace referencia al texto que se agrega a un archivo de descuento pero que la aplicación de representación ignora. Por lo tanto, no aparecerá ningún comentario de descuento en la salida generada. Los comentarios son útiles cuando necesita insertar texto oculto en su documento que solo es visible para el autor del documento pero no visible en el documento resultante.

Cómo insertar comentarios Markdown

Desafortunadamente, Markdown no tiene soporte nativo para comentarios. Sin embargo, puede usar soluciones importadas para agregar comentarios a su documento Markdown.

Método 1

La primera sintaxis para agregar un comentario en Markdown es colocar el texto de su comentario entre un par de corchetes, seguido de dos puntos, un espacio y un signo de libra. La sintaxis es la que se muestra: el texto entre corchetes se trata como un comentario y el renderizador de rebajas lo ignora. Un ejemplo se ve así: ## Markdown Comentario IlustraciónEste es un párrafo[this is a comment]: #El comentario anterior no es visible. En el ejemplo anterior, tenemos una sintaxis de rebajas simple con un encabezado, un párrafo, un comentario y otro párrafo.

método 2

La siguiente sintaxis también puede insertar comentarios en un documento Markdown.
[//]:# (el texto del comentario va aquí) Este se considera el formato más compatible con la plataforma para agregar comentarios. Otra variación de esta sintaxis es:
[//]:# «el texto del comentario va aquí»

método 3

En algunos motores de rebajas, puede omitir las dos barras diagonales y usar la siguiente sintaxis:
[]: # (texto de comentario) o[]: # «texto de comentario» o[]:# ‘texto de comentario’

método 4

También puede incluir comentarios HTML en Markdown, como se muestra en la siguiente sintaxis: Las aplicaciones de rebajas populares admiten el método anterior.

método 5

Github también te permite usar la siguiente sintaxis para indicar comentarios: {:: comentario}texto de comentario{:/comentario} Aunque la sintaxis anterior no se adopta ni se usa convencionalmente.

Concluir

En este tutorial, descubrió cinco formas efectivas de agregar comentarios a su comentario de Markdown.