Como probablemente hayas visto en artículos anteriores, aquí en MakeUseOf somos fanáticos de Markdown. Al aprender este formato simple e intuitivo, puede crear fácilmente resultados atractivos. Desde PDF a páginas web, su humilde archivo de texto simple se convierte en un documento sofisticado..

Pero Markdown no es el único juego en la ciudad. Hay una serie de otros denominados lenguajes de marcado de peso ligero similares a Markdown pero con diferentes conjuntos de características. Uno de estos es el asciidoc. Si te gusta Markdown pero buscas un poco más bajo el capó, vale la pena considerarlo. Aquí hay algunas razones de por qué.

Que es un “Lenguaje de marcado” De todas formas?

UNA lenguaje de marcado es un conjunto de códigos que, cuando se aplica a un texto simple, le permite agregar una o más de las siguientes propiedades (entre otras):

• Define el texto
• Estructurar el texto
• Describe el diseño del texto.
• Decora el texto

Un lenguaje de marcado que encuentras todos los días (a menos que seas un ermitaño) es el lenguaje de marcado de hipertexto o HTML. Los sitios web y las aplicaciones que le traen noticias y le muestran su correo electrónico están construidas, al menos en parte, con el marcado HTML. Aprenda HTML y CSS con estos tutoriales paso a paso Aprenda HTML y CSS con estos tutoriales paso a paso. y JavaScript? Si crees que tienes una habilidad para aprender a crear sitios web desde cero, aquí hay algunos tutoriales paso a paso que vale la pena probar. Lee mas . HTML hace uso de etiquetas Como el mecanismo para marcar el contenido del texto en bruto. Por ejemplo, considere el siguiente fragmento de código HTML:

 
Introduciendo HTML
 
Aquí hay un párrafo en HTML ... sabemos que es un párrafo porque el entorno \ las etiquetas lo definen como uno.
 

Aquí el

etiqueta especifica que todo el texto a seguir, hasta su cierre

Pero tenga en cuenta también la etiquetas ... a menudo sirven para definir el diseño de una página web, como la cantidad de margen que hay desde el lado de la pantalla.

Y el etiquetas decorarán la palabra “párrafo” en una fuente en negrita, mientras que la

Las etiquetas pueden tanto colocar el encabezado (separándolo del texto circundante) como definir una fuente más grande.

El problema con algunos lenguajes de marcado (HTML entre ellos) es que escribir estas etiquetas manualmente es un asunto muy tedioso. Y con otros lenguajes como XML ¿Qué es un archivo XML y cuáles son sus usos? [En caso de que te estuvieras preguntando] ¿Qué es un archivo XML y cuáles son sus usos? [En caso de que te estuvieras preguntando] ¡Lea más, las etiquetas y sus atributos conforman una porción más grande del contenido general que el propio texto! Eche un vistazo al siguiente fragmento de DocBook, un dialecto XML que se utiliza para crear muchas publicaciones técnicas:

Todo el texto en púrpura representa las etiquetas que necesitarías escribir solo. El primer párrafo no comienza hasta el final de esa imagen. Y si no se hace exactamente de acuerdo con el estándar DocBook, no podrá convertirlo en el bonito documento PDF que suele ser el objetivo final..

Introduzca el lenguaje de marcado ligero

Si desea aprovechar los lenguajes de marcado, por ejemplo, publicando una página HTML en la web o convirtiendo un archivo DocBook a PDF para que pueda imprimirse, tenía que hacer una de dos cosas. Por un lado, podrías invertir tiempo aprendiendo estos idiomas por dentro y por fuera, escribiéndolos a mano y luego revisando tu trabajo por triplicado. O podría invertir dinero en una herramienta que gestione la complejidad de estos para usted..

Afortunadamente, a algunos desarrolladores emprendedores se les ocurrió una tercera opción. Crearon nuevos lenguajes de marcado que contenían muchas (en algunos casos la mayoría o todas) de las características de las contrapartes más pesadas, pero simplificaron en gran medida la sintaxis. Estas “ligero” Los idiomas incluyen el Markdown familiar ¿Qué es Markdown? 4 razones por las que deberías aprenderlo ahora ¿Qué es Markdown? 4 razones por las que deberías aprenderlo ¿Estás cansado de los editores HTML y WYSIWYG? Entonces Markdown es la respuesta para ti, no importa quién seas. Lea más, así como Asciidoc, el formato Org-Mode de Emac y la sintaxis de Mediawiki..

Los lenguajes de marcado de peso ligero tienen sintaxis simple

Un sello distintivo de estos idiomas es que su “etiquetas” (como son) deben ser intuitivos. Echemos un vistazo al fragmento anterior, esta vez escrito en Asciidoc:

Presentación de Asciidoc -------------------- ¿Dónde están las etiquetas * párrafo *? No los necesitamos ... Asciidoc es lo suficientemente inteligente como para darse cuenta de que esto es un párrafo!

Mucho más legible, ¿no? Comenzando en la parte superior, podemos identificar el encabezado ya que es “testado” con guiones. Puede hacer esto si estuviera escrito a mano, simplemente dibuje un subrayado debajo del título de la página en su cuaderno. Tampoco hay etiquetas de párrafo. Asciidoc considera que cualquier cosa entre dos líneas vacías que no tenga otro tipo de marca sea “llanura” texto de párrafo. Finalmente, los asteriscos alrededor de la palabra. “párrafo” indicar negrita Levanta la mano si has hecho esto en un mensaje de texto para decir exactamente lo mismo.

Cada uno tiene uno o más procesadores correspondientes

los “de peso pesado” Los lenguajes de marcado suelen tener una aplicación dedicada para interpretarlos. En la web, es su navegador y, posiblemente, el servidor web el que convertirá el código en páginas web llamativas. Todo lo que necesita saber sobre los sistemas de administración de contenido Todo lo que necesita saber sobre los sistemas de administración de contenido Para el usuario promedio de Internet, vea el contenido. es fácil. Abre un enlace y aparece la página. Pero, ¿qué está pasando detrás de las escenas? Así es como sus CMS favoritos se encargan de los negocios. Lee mas . Para documentos en XML, podría ser algo como Microsoft Word, que lee y escribe en formato DOCX Cómo abrir archivos DOCX de Microsoft Word 2007 Cómo abrir archivos DOCX de Microsoft Word 2007 ¿Alguna vez ha recibido uno de esos archivos con la extensión .docx y se preguntó qué hacer con él? No se puede ver en versiones anteriores de Word, entonces, ¿cómo puede abrir un archivo .docx? ... Leer más (que es otro dialecto XML). Nunca tendrá que interactuar directamente con la fuente de estos documentos, solo las hermosas fachadas que le muestran sus aplicaciones..

Mientras tanto, los documentos escritos en lenguajes livianos son legibles para los humanos en forma de fuente (otro inquilino), pero solo los nerds verdaderos pueden pensar que son hermosos. Para obtener un buen rendimiento, necesitas utilizar un procesador. Estas son aplicaciones que se ejecutarán a través de su marca línea por línea y las convertirán en otra cosa que se vea bien. Los mismos proyectos que desarrollan el lenguaje en sí mismo típicamente producirán una utilidad para acompañarlo. El proyecto Markdown ofrece un script Perl con el mismo nombre, y el programa complementario de Asciidoc está escrito en Python. Además, otras utilidades de conversión incluirán soporte para algunos de estos idiomas. Uno de ellos es el excelente Pandoc Cómo convertir fácilmente entre formatos de documentos en Linux Cómo convertir fácilmente entre formatos de documentos en Linux El cambio a Linux puede dar lugar a problemas con la compatibilidad de archivos. Por ejemplo, los documentos no se ven igual en LibreOffice como lo hacen en Word. Esta es solo una de las razones por las que necesitas pandoc. Lea más, que tomará Markdown así como las marcas ligeras rediseñadas en Text, Mediawiki y Org-Mode y las convertirá a PDF, DOCX, ODT y más.

El resultado es que los lenguajes de marcado de peso ligero le permiten trabajar en texto plano, el formato de datos más portátil del planeta, y al mismo tiempo producir una salida atractiva al final. Ahora que está convencido de sus méritos, ¿qué idioma debe elegir? Markdown es, sin duda, el más popular y tiene sus ventajas (más sobre esto más adelante). Pero el asciidoc en particular es una alternativa digna. En la siguiente sección exploraremos un par de razones por las que.

Comparando Markdown y Asciidoc

El formato Asciidoc se creó para brindar una simplicidad liviana a DocBook, uno de los formatos más comunes en escritura de formato largo (especialmente técnico). Una de sus afirmaciones a la fama es que es una traducción uno a uno, lo que significa que para cada elemento de DocBook, hay una representación correspondiente en Asciidoc. A continuación veremos algunos de los pros y los contras de Asciidoc en comparación con Markdown..

Asciidoc cubre un superconjunto de elementos de escritura

El objetivo de Markdown desde el principio era ser un formato simple para escritores web. Como tal, los elementos de escritura que admite (al menos la implementación original, ver más abajo) se centran en la automatización de los aspectos más intensivos en el tiempo de escritura de HTML (listas, por ejemplo, que requieren la

o
etiquetas además de
• etiquetas para cada elemento).

  

  Asciidoc también contiene estos, pero también ofrece elementos DocBook más avanzados, como advertencias (por ejemplo,. “Nota:” o “Información:” bloques de llamada) y diseños de tablas complejas. No significa que tu necesitar para usarlos todo el tiempo, pero estarán allí y disponibles si alguna vez los necesita.

  Asciidoc es un formato unificado

  Cuando la popularidad de Markdown comenzó a despegar, algunos de sus usuarios comenzaron a encontrarse con algunas de las deficiencias mencionadas anteriormente. Así que estos usuarios comenzaron a desarrollar sus propias extensiones para resolver estos problemas, como la capacidad de agregar tablas o notas al pie / finales. Pronto hubo muchos “sabores” de Markdown, incluyendo (entre otros):

  • El sabor utilizado por Github para el “Readme” Archivos de proyectos alojados..
  • Un “extendido” Sabor que nace de un puerto PHP de Markdown original con características adicionales relacionadas con HTML.
  • Un sabor llamado “MultiMarkdown” que implementó muchas características de escritura de formato más largo, incluidas citas, definiciones y referencias cruzadas.

  El resultado es que su documento puede requerir elementos que no están todos cubiertos por un solo sabor. En contraste, Asciidoc no sufre la misma fragmentación que Markdown en la actualidad.

  Asciidoc se dirige a una variedad de estilos de publicación

  Markdown es ideal para sacar rápidamente una publicación de blog de tu cabeza y colocarla en la página. Pero fuera de la caja, no está diseñado para estructurar trabajos más largos, como un libro. Asciidoc está diseñado para esto, y un ejemplo es su “incluir” funciones Estas declaraciones le permiten incluir todo el contenido de un archivo en otro:

  incluye :: somefile.adoc

  Esto no es diferente de cómo funcionan los documentos maestros en los procesadores de texto. Esto le permite, por ejemplo, redactar cada capítulo como un archivo separado, luego “incluir” todos ellos en un archivo que representa el libro. Cuando procesas eso “archivo de libro,” La salida será como si todos los capítulos se escribieran directamente en ese documento..

  Markdown es suficiente para la mayoría de los usuarios

  Markdown cubre todas las bases para una mayor porción de usuarios. Para aquellos que simplemente buscan un blog, o escriben algunas notas en formato de texto plano, Markdown soporta todos los elementos que necesitarán. Las referencias cruzadas no significan mucho para un usuario que solo quiere crear una nota simple o una página web. Incluso podría utilizar Markdown para trabajos más largos con diseños simples, como una novela ¿Quién necesita a Scrivener? 5 Novedosas aplicaciones de escritura para Linux ¿Quién necesita Scrivener? 5 Novedosas aplicaciones de escritura para Linux Scrivener no está disponible para Linux, así que, ¿cómo hará un seguimiento de dónde van estos personajes, qué hicieron y cómo completan su viaje? Bueno, una de estas herramientas debería ayudar. Lee más, y combínalos tú mismo al final..

  Markdown es mejor soportado

  Dado que Markdown satisface las necesidades de un segmento más grande de usuarios, terminó siendo mejor soportado en términos de lo siguiente:

  • Los editores WYSIWYG (definidos por aquellos que al menos proporcionan una vista previa en vivo) son mucho más propensos a soportar Markdown.
  • Los servicios en línea, como el mencionado Github, es más probable que acepten Markdown directamente o mediante el uso de addons. 6 Editores Markdown que juegan bien con Google Drive. Es más simple, elegante y fácil de usar que HTML sin sacrificar mucha potencia o flexibilidad. Lee mas .
  • Aunque los sistemas de publicación como los generadores de sitios estáticos 7 razones para deshacerse de su CMS y considerar un generador de sitios estáticos 7 razones para deshacerse de su CMS y considerar un generador de sitios estáticos Durante muchos años, publicar un sitio web fue difícil para muchos usuarios. Los CMS como WordPress cambiaron eso, pero todavía pueden ser confusos. Otra alternativa es un generador de sitio estático. Leer más a menudo es compatible con Asciidoc con complementos, que admiten Markdown fuera de la caja es casi un hecho.

  ¿Estás dispuesto a probar Asciidoc??

  Si bien Markdown es una elección de facto entre los lenguajes de marcado ligero, Asciidoc contiene todos los mismos elementos y algunos. Los extras de Asciidoc requieren algo de tiempo para aprender, ya que pueden prepararse mejor para proyectos de escritura más grandes y complejos..

  ¿Qué piensas? ¿Estás contento con la simplicidad de Markdown? ¿O es atractivo crear su propio flujo de trabajo de publicación multicanal con Asciidoc? ¿Tal vez odias el texto plano y es Word para ti? Háganos saber en los comentarios a continuación.!

  Explorar más sobre: ​​Markdown, Consejos para escribir.