El lenguaje de marcado viene en muchos sabores, algunos de los cuales son mejores que otros. Los lenguajes ligeros como AsciiDoc son fáciles de aprender y extremadamente útiles. Así es como se compara.

Anuncio

Como probablemente haya visto en artículos anteriores, aquí en MakeUseOf somos fanáticos de Markdown What Is Markdown? 4 razones por las que debería aprender ahora ¿Qué es Markdown? 4 razones por las que debería aprender ahora ¿Cansado de los editores HTML y WYSIWYG? Entonces Markdown es la respuesta para ti sin importar quién eres. Lee mas . Al aprender este formato simple e intuitivo, puede crear fácilmente resultados agradables. Desde archivos PDF a páginas web, su humilde archivo de texto plano 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 ligeros similares a Markdown pero con diferentes conjuntos de características. Uno de estos es Asciidoc. Si te gusta Markdown pero estás buscando un poco más bajo el capó, vale la pena considerarlo. Aquí hay algunas razones de por qué.

¿Qué es un "lenguaje de marcado" de todos modos?

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

Definir 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 brindan noticias y le muestran su correo electrónico están construidos, al menos en parte, con etiquetas HTML Aprenda HTML y CSS con estos tutoriales paso a paso Aprenda HTML y CSS con estos tutoriales paso a paso Curiosidades sobre HTML, CSS y JavaScript? Si crees que tienes una habilidad especial para aprender a crear sitios web desde cero, aquí hay algunos tutoriales paso a paso que vale la pena probar. Lee mas . HTML utiliza etiquetas como el mecanismo para marcar el contenido de texto sin formato. Por ejemplo, considere el siguiente fragmento de HTML:

Introduciendo HTML

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

Aquí el

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

etiqueta, es un párrafo. En este sentido, define el texto como un párrafo.

Pero tenga en cuenta también las 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 las etiquetas decorarán la palabra "párrafo" en negrita, mientras que

las etiquetas pueden tanto diseñar el encabezado (espaciando el 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 se esté preguntando] ¿Qué es un archivo XML y cuáles son sus usos? [En caso de que se lo pregunte] ¡Lea más, las etiquetas y sus atributos constituyen una porción más grande del contenido general que el texto en sí! Eche un vistazo al siguiente fragmento de DocBook, un dialecto XML utilizado para crear muchas publicaciones técnicas:
Todo el texto en púrpura representa las etiquetas que necesitarías escribir por ti mismo. El primer párrafo no comienza hasta la parte inferior 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.

Ingrese 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 en PDF para que se pueda imprimir, debe hacer una de estas dos cosas. Por un lado, podría invertir tiempo aprendiendo estos idiomas por dentro y por fuera, escribiéndolos a mano, y luego comprobando tres veces su trabajo. O podría invertir dinero en una herramienta que maneje la complejidad de estos para usted.

Afortunadamente, algunos desarrolladores emprendedores encontraron una tercera opción. Crearon nuevos lenguajes de marcado que contenían muchas (en algunos casos la mayoría o la totalidad) de las características de las contrapartes más pesadas, pero simplificaron en gran medida la sintaxis. Estos idiomas "ligeros" incluyen el familiar Markdown What Is Markdown? 4 razones por las que debería aprender ahora ¿Qué es Markdown? 4 razones por las que debería aprender ahora ¿Cansado de los editores HTML y WYSIWYG? Entonces Markdown es la respuesta para ti sin importar quién eres. Lea más, así como Asciidoc, el formato Org-Mode de Emac y la sintaxis de Mediawiki.

Los lenguajes de marcado ligeros tienen sintaxis simple

Una característica distintiva de estos lenguajes es que sus "etiquetas" (como lo son) deberían ser intuitivas. Echemos un vistazo al fragmento anterior, esta vez escrito en Asciidoc:

 Introducing Asciidoc -------------------- Where are the *paragraph* tags? We dont need them... Asciidoc is smart enough to realize this is a paragraph!

Mucho más legible, ¿no? Comenzando en la parte superior, podemos identificar el encabezado ya que está "subrayado" con guiones. Puede hacer esto si escribió 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 tengan algún otro marcado sea un texto de párrafo "simple". Finalmente, los asteriscos alrededor de la palabra "párrafo" indican 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 lenguajes de marcado "heavyweight" suelen tener una aplicación dedicada para interpretarlos por usted. En la web, es su navegador y posiblemente el servidor web el que convertirá el código en llamativas páginas web Todo lo que necesita saber sobre sistemas de gestión de contenidos Todo lo que necesita saber sobre sistemas de gestión de contenidos Para el internauta promedio, viendo contenido es fácil. Usted abre un enlace y aparece la página. Pero, ¿qué está sucediendo detrás de escena? Así es como sus CMS favoritos se encargan de los negocios. Lee mas . Para documentos en XML, podría ser algo así 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 recibió uno de esos archivos con la extensión .docx y se preguntó qué hacer con eso? No se puede ver en versiones anteriores de Word, entonces, ¿cómo se puede abrir un archivo .docx ... Leer más (que es otro dialecto XML). Por lo tanto, nunca tendrá que interactuar directamente con la fuente de estos documentos, solo las bonitas fachadas que le mostrarán sus aplicaciones.

Mientras tanto, los documentos escritos en idiomas livianos son legibles por humanos en forma de fuente (otro inquilino), pero solo los verdaderos nerds pueden pensar que son hermosos. Para obtener resultados bonitos, debe usar un procesador . Estas son aplicaciones que se ejecutarán a través de su marcado línea por línea y lo convertirá en otra cosa que se ve bien. Los mismos proyectos que desarrollan el lenguaje en sí mismo típicamente producirán una utilidad que lo acompañe. El proyecto Markdown ofrece una secuencia de comandos Perl del 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 ocasionar problemas con la compatibilidad de archivos. Por ejemplo, los documentos no se ven iguales en LibreOffice que en Word. Esta es solo una razón por la que necesita Pandoc. Lea más, que tomará Markdown, así como también marcas ligeras, texto estructurado, Mediawiki y modo orgánico y las convertirá a PDF, DOCX, ODT y más.

formatos asciidoc markdown pandoc

El resultado es que los lenguajes de marcado livianos te permiten trabajar en texto plano, el formato de datos más portátil del planeta, y al mismo tiempo producir resultados agradables 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 Asciidoc en particular es una alternativa digna. En la siguiente sección, exploraremos un par de razones por qué.

Comparando Markdown y Asciidoc

El formato Asciidoc fue creado con el fin de brindar una simplicidad liviana a DocBook, uno de los formatos más comunes en la escritura de forma larga (especialmente técnica). Una de sus afirmaciones de la fama es que es una traducción uno a uno, lo que significa que para cada elemento en DocBook, hay una representación correspondiente en Asciidoc. A continuación, echaremos un vistazo a 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 a continuación) se centran en la automatización de los aspectos más intensivos de tiempo de escritura HTML (listas, por ejemplo, que requieren la

etiquetas para cada artículo).
Asciidoc también contiene estos, pero también ofrece elementos más avanzados de DocBook, como admoniciones (por ejemplo, "Nota:" o "Información:" bloques de texto destacado) y diseños complejos de tablas. No significa que deba usarlos todo el tiempo, pero estarán disponibles 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. Entonces, estos usuarios comenzaron a desarrollar sus propias extensiones para resolver estos problemas, como la posibilidad de agregar tablas o pies / notas finales. Pronto hubo muchos "sabores" de Markdown, que incluyen (entre otros):
- El sabor utilizado por Github para los archivos "Léame" de proyectos alojados.
- Un sabor "extendido" nacido de un puerto PHP del Markdown original con características adicionales relacionadas con HTML.
- Un sabor llamado "MultiMarkdown" que implementa muchas características de la escritura de forma más larga, incluyendo citas, definiciones y referencias cruzadas.
El resultado es que su documento puede requerir elementos que no están todos cubiertos por un único sabor. Por el contrario, Asciidoc no sufre la misma fragmentación que Markdown en la actualidad.
Asciidoc se enfoca en una variedad de estilos de publicación
Markdown es ideal para obtener rápidamente una publicación de blog fuera de su cabeza y 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 son sus funciones de "inclusión". Estas declaraciones le permiten incluir todo el contenido de un archivo en otro:
```
 include::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, y luego "incluirlos" en un solo archivo que representa el libro. Cuando procesa ese "archivo de libro", el resultado 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 blog o escriben algunas notas en un formato de texto plano, Markdown admite todos los elementos que necesitarán. Las referencias cruzadas no significan mucho para un usuario que solo quiere crear un memo simple o una página web. Incluso podría usar Markdown para trabajos más largos con diseños simples, como la novela Who Needs Scrivener? 5 nuevas aplicaciones de escritura para Linux ¿Quién necesita Scrivener? 5 Novelas aplicaciones de escritura para Linux Scrivener no está disponible para Linux. Entonces, ¿cómo hará un seguimiento de dónde van estos personajes, qué han hecho y cómo completan su recorrido? Bueno, una de estas herramientas debería ayudar. Lea más, y combínelos usted mismo al final.
Markdown es mejor apoyado
Como Markdown cumple con las necesidades de un segmento más grande de usuarios, terminó mejor respaldado en términos de lo siguiente:
- Los editores WYSIWYG (tal como los definen aquellos que, al menos, proporcionan una vista previa en vivo) son mucho más propensos a admitir Markdown.
- Los servicios en línea, como el ya mencionado Github, son más propensos a aceptar Markdown directamente o mediante el uso de complementos. 6 Markdown Editores que juegan bien con Google Drive 6 Markdown Editores que juegan bien con Google Drive Markdown es el formato de edición de texto del futuro. Es más simple, elegante y fácil de usar que HTML sin sacrificar mucha potencia o flexibilidad. Lee mas .
- Aunque publicar sistemas como generadores de sitios estáticos 7 Razones para abandonar tu CMS y considerar un generador de sitios estáticos 7 Razones para abandonar tu CMS y considerar un generador de sitios estáticos Durante muchos años, la publicación de 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 sitios estáticos. Read More a menudo admite Asciidoc con complementos, que admiten Markdown de forma predeterminada.
¿Estás dispuesto a probar Asciidoc?
Si bien Markdown es una elección de hecho entre los lenguajes de marcado ligero, Asciidoc contiene todos los mismos elementos y algo más. 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 está creando su propio flujo de trabajo de publicación multicanal con atractivo de Asciidoc? Tal vez odias el texto simple y es la palabra todo el camino para ti? Háganos saber en los comentarios a continuación!