Reducción

Markdown ^{[ 9 ]} es un lenguaje de marcado ligero para crear texto formateado usando un editor de texto plano . John Gruber creó Markdown en 2004 como un lenguaje de marcado fácil de leer . ^{[ 9 ]} Markdown se usa ampliamente para blogs , mensajería instantánea y grandes modelos de lenguaje , ^{[ 10 ]} y también se usa en otros lugares en foros en línea , software colaborativo , páginas de documentación y archivos readme .

La descripción inicial de Markdown ^{[ 11 ]} contenía ambigüedades y planteaba interrogantes sin respuesta, lo que provocó que las implementaciones divergieran, tanto intencional como accidentalmente, de la versión original. Esto se solucionó en 2014 cuando colaboradores veteranos de Markdown publicaron CommonMark , una especificación y un conjunto de pruebas inequívocos para Markdown. ^{[ 12 ]}

Markdown se inspiró en convenciones preexistentes para marcar texto plano en correos electrónicos y publicaciones de Usenet , ^{[ 13 ]} como los lenguajes de marcado anteriores setext ( c. 1992 ), Textile ( c. 2002 ) y reStructuredText ( c. 2002 ). ^{[ 9 ]}

En 2002, Aaron Swartz creó atx y lo denominó "el verdadero formato de texto estructurado". Gruber creó el lenguaje Markdown en 2004 con Swartz como su "columna de consulta". ^{[ 14 ]} El objetivo del lenguaje era permitir a las personas "escribir utilizando un formato de texto plano fácil de leer y escribir, y convertirlo opcionalmente a XHTML (o HTML ) estructuralmente válido". ^{[ 5 ]}

Otro objetivo clave del diseño era la legibilidad , que el lenguaje fuera legible tal cual, sin parecer que se le han añadido etiquetas o instrucciones de formato, ^{[ 9 ]} a diferencia del texto formateado con lenguajes de marcado "más pesados" , como el formato de texto enriquecido (RTF), HTML o incluso wikitext , cada uno de los cuales tiene etiquetas en línea obvias e instrucciones de formato que pueden dificultar la lectura del texto para los humanos.

Gruber escribió un script en PerlMarkdown.pl que convierte la entrada de texto con formato a XHTML o HTML válido y bien formado< , codificando los corchetes angulares ( , >) y las ampersands ( &), que serían malinterpretadas como caracteres especiales en esos lenguajes. Puede funcionar como un script independiente, un complemento para Blosxom o Movable Type , o como un filtro de texto para BBEdit . ^{[ 5 ]}

A medida que la popularidad de Markdown creció rápidamente, aparecieron muchas implementaciones de Markdown , impulsadas principalmente por la necesidad de características adicionales como tablas , notas al pie , listas de definiciones, ^{[ nota 1 ]} y Markdown dentro de bloques HTML.

El comportamiento de algunos de estos divergió de la implementación de referencia, ya que Markdown solo se caracterizó por una especificación informal ^{[ 17 ]} y una implementación de Perl para la conversión a HTML.

Al mismo tiempo, varias ambigüedades en la especificación informal habían llamado la atención. ^{[ 18 ]} Estos problemas impulsaron la creación de herramientas como Babelmark ^{[ 19 ] [ 20 ]} para comparar la salida de varias implementaciones, ^{[ 21 ]} y un esfuerzo de algunos desarrolladores de analizadores de Markdown para la estandarización. Sin embargo, Gruber ha argumentado que la estandarización completa sería un error: «Diferentes sitios (y personas) tienen diferentes necesidades. Ninguna sintaxis satisfaría a todos». ^{[ 22 ]}

Gruber evitó usar llaves en Markdown para reservarlas extraoficialmente para extensiones específicas de la implementación. ^{[ 23 ]}

Normalización

En 2012, un grupo de personas, entre ellas Jeff Atwood y John MacFarlane , lanzaron lo que Atwood caracterizó como un esfuerzo de estandarización. ^{[ 12 ]}

Un sitio web comunitario ahora tiene como objetivo "documentar varias herramientas y recursos disponibles para autores y desarrolladores de documentos, así como implementadores de las diversas implementaciones de Markdown". ^{[ 26 ]}

Nombre

En septiembre de 2014, Gruber se opuso al uso de "Markdown" en el nombre de este proyecto y se le cambió el nombre a "CommonMark". ^{[ 13 ] [ 27 ] [ 28 ]} CommonMark.org publicó varias versiones de una especificación, una implementación de referencia, un conjunto de pruebas y "[planes] para anunciar una especificación y un conjunto de pruebas 1.0 finalizados en 2019". ^{[ 29 ]} No se ha publicado una especificación 1.0 finalizada, ya que aún quedan problemas importantes sin resolver. ^{[ 30 ]}

Adopción

No obstante, varios sitios web y proyectos han adoptado CommonMark, entre ellos Codeberg , Discourse , GitHub , GitLab , Reddit , Qt , Stack Exchange ( Stack Overflow ) y Swift .

En marzo de 2016 se publicaron dos RFC informativos relevantes sobre Internet:

• RFC 7763 – " El tipo de medio text/markdown, " ^{[ 2 ]} Informativo. 
  Introduce el tipo MIMEtext/markdown .
• RFC 7764 – " Guía sobre Markdown: filosofías de diseño, estrategias de estabilidad y registros seleccionados " , ^{[ 7 ]} Informativo. 
  Analiza y registra las variantes MultiMarkdown , GitHub Flavored Markdown (GFM), Pandoc y Markdown Extra (entre otras). ^{[ 31 ]}

Sitios web como Bitbucket , Diaspora , Discord , ^{[ 32 ]} GitHub , ^{[ 33 ]} OpenStreetMap , Reddit , ^{[ 34 ]} SourceForge ^{[ 35 ]} y Stack Exchange ^{[ 36 ]} utilizan variantes de Markdown para facilitar las discusiones entre usuarios.

Dependiendo de la implementación, es posible que se admitan etiquetas HTML básicas en línea . ^{[ 37 ]}

El texto en cursiva puede implementarse mediante _underscores_o *single-asterisks*. ^{[ 38 ]}

Muchas plataformas implementan un formato de spoiler que oculta el texto hasta que se pasa el cursor por encima, se hace clic o se toca. El marcado más común es ||spoiler|| utilizado por Discord ^{[ 39 ]} , Telegram ^{[ 40 ] [ 41 ]} , varios clientes de Matrix ^{[ 42 ]} , el ahora desaparecido Guilded ^{[ 43 ]} , un foro llamado Flarum ^{[ 44 ]} , un complemento de NodeBB ^{[ 45 ]} , el motor de tablón de imágenes JSChan ^{[ 46 ]} y posiblemente más.

Existen implementaciones de Markdown para más de una docena de lenguajes de programación ; además, muchas aplicaciones , plataformas y marcos de trabajo son compatibles con Markdown. ^{[ 53 ]} Por ejemplo, existen complementos de Markdown para todas las principales plataformas de blogs . ^{[ 13 ]}

Aunque Markdown es un lenguaje de marcado minimalista que se lee y edita con un editor de texto normal , existen editores especialmente diseñados que muestran una vista previa de los archivos con estilos, disponibles para las principales plataformas. Muchos editores de texto y código de uso general incluyen complementos de resaltado de sintaxis para Markdown o los ofrecen como descarga opcional. Algunos editores muestran una vista previa en paralelo o renderizan el código directamente en formato WYSIWYG ( lo que ves es lo que obtienes) .

• Comparación de lenguajes de marcado de documentos
• Comparación de generadores de documentación
• Comparación de software wiki
• Lenguaje de marcado ligero
• Lista de lenguajes de marcado
• Lista de editores de texto
• Marcado wiki

• Sitio web oficial del código original de John Gruber.