Yo me enseñé HTML hace mucho tiempo, en un software llamado HotDog (Pro?). No había tal cosa como What You See Is What You Get capacidades en ese momento. Sin embargo, HotDog tenía una característica increíble: la barra de herramientas tenía todas las etiquetas HTML (no había tantas en ese momento) como botones, y usted podía aprenderlos haciendo clic en ellos y viendo los resultados. Después vino Dreamweaver. Fue el primer editor WYSIWYG, y se volvió muy popular de inmediato. Las personas que no tenían idea de HTML comenzaron a usarlo: el número de sitios web creció rápidamente. Lo usé una vez y miré el HTML generado. Después de haber aprendido a escribir HTML "por mano", lo encontré generado por Dreamweaver abiertamente verbose. Siguió escribiendo mi HTML a mano o con la ayuda de IDEs. HTML pasó más allá de los sitios web para ser un formato omnipresente que Sir Berners-Lee no habría soñado que se convertiría. Junto con los navegadores web, se convirtió en el medio para las aplicaciones web. Sin embargo, no se detuvo allí. Incluso en ese momento, me sorprendió que JavaDocs generara HTML. Creación de HTML. Creación de HTML. Creación de HTML. Python Doctrinamiento Rubí RDOC Ruta de los Rojos Si usted puede escribir HTML, , en JavaDocs, escribir HTML por la línea se convierte en un borrador bastante rápido. es fácil perder un slash en la etiqueta de cierre, o para obtener un Sin embargo, la mayoría de la documentación no necesita el poder total de HTML, especialmente el tipo que traen sus versiones más modernas. El E.G. <table> Para abordar este problema, John Gruber y Aaron Swartz inventaron Markdown en 2004. 
 
 
 Markdown es un lenguaje de marcado ligero para crear texto formatado utilizando un editor de texto simple.John Gruber creó Markdown en 2004 como un lenguaje de marcado fácil de leer. El Markdown Markdown es un lenguaje de marcado ligero para crear texto formatado utilizando un editor de texto simple.John Gruber creó Markdown en 2004 como un lenguaje de marcado fácil de leer. - - - El Markdown Markdown tomó el mundo por la tormenta. creo que es aún más popular que HTML, al menos en el mundo de la tecnología. Ha estado disponible en GitHub durante siglos. Java lo integró en sus JavaDocs en la versión 25. Limitaciones de Markdown Markdown es increíble, pero tiene fuertes limitaciones.He escrito mi último libro con Markdown, en la tradición Doc-as-Code. He aquí un extracto simple de mi experiencia de escritura de libros.Quise incluir fragmentos de código para ilustrar mis puntos. Sin embargo, quería que fueran válidos: compilados y probados.He escrito un proyecto, completo con una configuración de construcción. Sin embargo, Markdown no permite la inclusión de archivos externos. Tuve que copiar y pegar los fragmentos requeridos. Lo peor, porque escribir un libro toma un tiempo, mantení la versión de las dependencias actualizada. Cada vez que lo hice, tuve que copiar y pegar el código actualizado en cada ocurrencia. Curiosamente, la documentación dirigida a desarrolladores tiene el mismo caso de uso. Otra limitación generalizada es querer llamar la atención a un elemento. Markdown no ofrece nada similar. Por esta razón, ¿Qué pasa con otros idiomas? no lo sé; me gustaría que fuera parte de Markdown. Desarrollo de Python Markdown Aunque hay muchos más, mi punto final será sobre las tablas. Markdown maneja las tablas, hasta un punto, que es los encabezados de columnas. y , que no son compatibles. Afortunadamente, HTML es válido Markdown. Sin embargo, la formatación dentro de la tabla, código, etc., debe ser transformado en HTML junto con él. rowspan colspan Ascendido Asciidoc es la solución a las limitaciones anteriores. 
 
 
 AsciiDoc es un lenguaje de marcado de texto simple para escribir contenido técnico. Está lleno de elementos semánticos y está equipado con funciones para modularizar y reutilizar el contenido. El contenido de AsciiDoc puede ser compuesto usando un editor de texto, gestionado en un sistema de control de versiones y publicado en múltiples formatos de salida. - Asciidoc AsciiDoc es un lenguaje de marcado de texto simple para escribir contenido técnico. Está lleno de elementos semánticos y está equipado con funciones para modularizar y reutilizar el contenido. El contenido de AsciiDoc puede ser compuesto usando un editor de texto, gestionado en un sistema de control de versiones y publicado en múltiples formatos de salida. - Asciidoc Veamos cómo Asciidoc aborda las limitaciones uno por uno: 
 
 
 
 
 
 
 : Include 
 
 An include directive imports content from a separate file or URL into the content of the current document. When the current document is processed, the include directive syntax is replaced by the contents of the include file. Think of the include directive like a file expander. 
 
 
 : Admonitions 
 
 There are certain statements you may want to draw attention to by taking them out of the content’s flow and labeling them with a priority. These are called admonitions. This page introduces you to admonition types AsciiDoc provides, how to add admonitions to your document, and how to enhance them using icons or emoji. 
 
 
 Cell span Asciidoc has a   as well as a  , both managed by the Eclipse Foundation. Note, though, that   is the sole implementation of Asciidoc. The Asciidoctor site is actually hosting the  . For most intents and purposes, you can treat them as one, as I do. specification TCK Asciidoctor Asciidoc documentation Una directiva incluye importa el contenido de un archivo separado o URL al contenido del documento actual. Cuando se procesa el documento actual, la sintaxis de la directiva incluye se sustituye por el contenido del archivo incluye. Hay ciertas declaraciones a las que puede querer llamar la atención tomándolas fuera del flujo de contenido y etiquetándolas con una prioridad.Estas se llaman advertencias.Esta página le presenta los tipos de advertencias que ofrece AsciiDoc, cómo añadir advertencias a su documento y cómo mejorarlas usando iconos o emoji. He listado arriba cómo Asciidoc resuelve tres limitaciones que encuentro regularmente en Markdown, pero ofrece muchos más beneficios. 
 
 
 
 
 
 
 
 
 
 : Video embedding A sample is more descriptive than a complete description: [source]
----
video::RX9zwgHuNmA[youtube,width=840,height=473]
----
 
 
 
   , as seen above: Blockquotes with attribution [quote,'https://asciidoc.org/[Asciidoc^]']
____
AsciiDoc is a plain text markup language for writing technical content.
____
 
 
 
 . This one is of utmost importance when I write self-driven workshops: Collapsible blocks [%collapsible]
====
This content is only revealed when the user clicks the block title.
====
 
 
 
 Materializing   is another useful feature for workshops and technical documentation in general: menus and buttons 
 
 
 
 
 Click on the OK button. 
 
 Go to the   item. Text > Text Filters > JSON 
 
 Automatic table of contents Con la cadena de herramientas correcta, puede generar HTML de Asciidoc y publicar el resultado en GitHub/GitLab Pages. Aplicaciones Apache Hands-on Lab Ecosistema de Asciidoc Una herramienta sólo es tan útil como su ecosistema circundante.Aquí hay un par de tales herramientas y beneficios: 
 
 
 
 
 
 
 GitHub renders Asciidoc as well as Markdown. Try using a   and watch the  . Here's a non-exhaustive list of  . README.adoc magic happen Asciidoc integration items with GitHub 
 
 Jekyll, the blog engine, has a seamless  . This blog runs on Jekyll with Asciidoc. Asciidoc integration 
 
 
 
 : Asciidoctor Diagram 
 
 Asciidoctor Diagram is a set of Asciidoctor extensions that enable rendering of plain text diagrams that are embedded in your AsciiDoc document as part of the Asciidoctor conversion process. I use it   with PlantUML. You might have noticed it on this blog already. a lot 
 
 
 : Reveal.js integration Asciidoc allows you to generate regular HTML documents, but Reveal.js enables the creation of slide-based presentations. When I taught at university, I used both regular HTML for seminar works and slides for courses. My old   is available as a GitHub Pages site (in French). Java EE course Icing on the cake, you can leverage the  . diagram integration Diagrama de Asciidoctor es un conjunto de extensiones de Asciidoctor que permiten renderizar diagramas de texto simple que se incorporan a su documento de Asciidoctor como parte del proceso de conversión de Asciidoctor. Conclusión Markdown está en todas partes, y estoy más que feliz si cumple con sus necesidades. tuve varias experiencias donde no cumplió con mis expectativas: documentación técnica, talleres, cursos y escritura de libros. Asciidoc es la herramienta perfecta para llenar las lagunas de Markdown. Espero que este post te haya dado suficientes argumentos para intentarlo. To go further: 
 
 
 
 
 Documentación Asciidoctor Siguiente Asciidoctor reveal.js Diagrama de Asciidoctor Plugin de Jekyll AsciiDoc Publicado originalmente en A Java Geek el 26 de octubre de 2025 El nuevo Java Geek

Read all my posts!

Read My Stories

Follow @nicolas_frankel on Twitter

Este audio es producido en el idioma original de la historia!

Asciidoc: cuando el Markdown no lo corta

About Author

COMENTARIOS

ETIQUETAS

ESTE ARTÍCULO FUE PRESENTADO EN

Related Stories

¿Quieres ganar un concurso de redacción de HackerNoon? Esto es lo que recomiendan los ganadores del concurso #crypto-api

Una guía del arquitecto para crear una arquitectura de referencia para un lago de datos de IA/ML

Toque para ganar: Telegram puede incorporar a los próximos 10 mil millones de usuarios de criptomonedas antes de Solana

Crecimiento de las criptomonedas: creación de perfiles de usuarios eficaces

¿Quieres ganar un concurso de redacción de HackerNoon? Esto es lo que recomiendan los ganadores del concurso #crypto-api

Una guía del arquitecto para crear una arquitectura de referencia para un lago de datos de IA/ML

Toque para ganar: Telegram puede incorporar a los próximos 10 mil millones de usuarios de criptomonedas antes de Solana

Crecimiento de las criptomonedas: creación de perfiles de usuarios eficaces

Light-Mode

Classic

Newspaper

Minty

Dark-Mode

Neon Noir

Minty

HN StartUps