J'ai appris HTML il y a longtemps, sur un logiciel appelé HotDog (Pro?). Il n'y avait pas de fonctionnalités comme What You See Is What You Get à l'époque. Cependant, HotDog avait une fonctionnalité étonnante: la barre d'outils avait toutes les balises HTML (il n'y en avait pas beaucoup à l'époque) en tant que boutons, et vous pouvez les apprendre en cliquant dessus et en regardant les résultats. Puis est venu Dreamweaver. C'était le premier éditeur WYSIWYG, et il est immédiatement devenu très populaire. Les gens qui n'avaient aucune idée de HTML ont commencé à l'utiliser: le nombre de sites Web a explosé. Je l'ai utilisé une fois et j'ai regardé le HTML généré. Après avoir appris à écrire HTML "par la main", je l'ai trouvé généré par Dreamweaver ouvertement verbose. J'ai continué à écrire mon HTML à la main ou avec l'aide d'IDEs. HTML est allé au-delà des sites Web pour être un format omniprésent que Sir Berners-Lee n'aurait pas rêvé qu'il devienne. Couplé avec les navigateurs Web, il est devenu le médium pour les applications Web. Générer du HTML. Générer du HTML. Générer du HTML. Python pour Docstring Rédigé par rdoc Résistance à Rustdoc Bien que vous puissiez écrire des snippets HTML, , dans JavaDocs, l'écriture HTML par la ligne devient un forage assez rapidement. Cependant, la plupart de la documentation n'a pas besoin de la pleine puissance de HTML, en particulier le genre apporté par ses versions plus modernes. par e.g. <table> Pour résoudre ce problème, John Gruber et Aaron Swartz ont inventé Markdown en 2004. 
 
 
 Markdown est un langage de balisage léger pour la création de texte formaté à l'aide d'un éditeur de texte simple. John Gruber a créé Markdown en 2004 comme un langage de balisage facile à lire. - Le Markdown Markdown est un langage de balisage léger pour la création de texte formaté à l'aide d'un éditeur de texte simple. John Gruber a créé Markdown en 2004 comme un langage de balisage facile à lire. - - - marquage Markdown a pris le monde par la tempête.Je pense qu'il est encore plus populaire que HTML, au moins dans le monde de la technologie.Il est disponible sur GitHub depuis des siècles.Java l'a intégré dans ses JavaDocs dans la version 25.Et aujourd'hui, les LLM utilisent Markdown pour l'entrée et la sortie! Les limites de Markdown Markdown est incroyable, mais il a de fortes limites. J'ai écrit mon dernier livre avec Markdown, dans la tradition Doc-as-Code. Voici un extrait simple de mon expérience d'écriture de livres. Je voulais inclure des extraits de code pour illustrer mes points. Cependant, je voulais qu'ils soient valides: compilés et testés. J'ai écrit un projet, complet avec une configuration de construction. Pourtant, Markdown ne permet pas l'inclusion de fichiers externes. J'ai dû copier et coller les extraits nécessaires. Pire, parce que l'écriture d'un livre prend du temps, j'ai tenu à jour la version des dépendances. Chaque fois que je l'ai fait, j'ai dû copier et coller le code mis à jour à chaque fois. Une autre limitation répandue est de vouloir attirer l'attention sur un élément. voici une option de style: Markdown n'offre rien de semblable. Qu’en est-il des autres langues ? je ne sais pas ; j’aimerais que ce soit une partie de Markdown. Python pour Markdown Bien qu'il y en ait beaucoup plus, mon dernier point sera sur les tables. Markdown traite des tables, jusqu'à un point, qui est des en-têtes de colonnes. et , qui ne sont pas pris en charge. Heureusement, HTML est valide Markdown. Cependant, la mise en forme à l'intérieur de la table, du code, etc., doit être transformée en HTML avec elle. rowspan colspan Ascidoc Asciidoc est la solution aux limitations ci-dessus. 
 
 
 AsciiDoc est un langage de marquage de texte simple pour l'écriture de contenu technique. Il est rempli d'éléments sémantiques et équipé de fonctionnalités pour modulariser et réutiliser le contenu. Le contenu AsciiDoc peut être composé à l'aide d'un éditeur de texte, géré dans un système de contrôle de version, et publié dans plusieurs formats de sortie. - Asciidoc AsciiDoc est un langage de marquage de texte simple pour l'écriture de contenu technique. Il est rempli d'éléments sémantiques et équipé de fonctionnalités pour modulariser et réutiliser le contenu. Le contenu AsciiDoc peut être composé à l'aide d'un éditeur de texte, géré dans un système de contrôle de version, et publié dans plusieurs formats de sortie. - Asciidoc Voyons comment Asciidoc aborde les limites une par une: 
 
 
 
 
 
 
 : 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 Une directive include importe le contenu d'un fichier ou d'une URL distincte dans le contenu du document actuel. Lorsque le document actuel est traité, la syntaxe de la directive include est remplacée par le contenu du fichier include. Il y a certaines déclarations que vous voudrez peut-être attirer l'attention en les retirant du flux de contenu et en les étiquetant avec une priorité. Ceux-ci sont appelés avertissements. Cette page vous présente les types d'avertissements AsciiDoc fournit, comment ajouter des avertissements à votre document, et comment les améliorer en utilisant des icônes ou des émojis. J'ai énuméré ci-dessus comment Asciidoc résout trois limitations que je rencontre régulièrement dans Markdown, mais il offre beaucoup plus d'avantages. 
 
 
 
 
 
 
 
 
 
 : 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 Avec la bonne chaîne d'outils, vous pouvez générer HTML à partir d'Asciidoc et publier le résultat sur GitHub/GitLab Pages. Apache APISIX pour Hands-on Lab Écosystème Asciidoc Un outil est seulement aussi utile que son écosystème environnant. Voici quelques-uns de ces outils et avantages: 
 
 
 
 
 
 
 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 Diagramme Asciidoctor est un ensemble d'extensions Asciidoctor qui permettent de rendre des diagrammes en texte simple qui sont intégrés dans votre document Asciidoctor dans le cadre du processus de conversion Asciidoctor. Conclusion Markdown est partout, et je suis plus que heureux si cela répond à vos besoins. J'ai eu plusieurs expériences où cela ne répond pas à mes attentes: documentation technique, ateliers, cours et écriture de livres. Asciidoc est l'outil parfait pour combler les lacunes de Markdown. J'espère que cet article vous a donné assez d'arguments pour l'essayer. To go further: 
 
 
 
 
 Documentaire Asciidocteur Avis sur Asciidoctor reveal.js Diagramme de l'asciidocteur Jekyll AsciiDoc Plugin Publié à A Java Geek le 26 octobre 2025 Le Java Geek

Read all my posts!

Read My Stories

Follow @nicolas_frankel on Twitter

Cet audio est produit dans la langue originale de l'histoire !

Asciidoc : Quand Markdown ne coupe pas

About Author

COMMENTAIRES

ÉTIQUETTES

CET ARTICLE A ÉTÉ PARU DANS

Related Stories

Naviguer sur les eaux : développer des applications RAG de qualité production avec des lacs de données

Comment améliorer votre flux de travail par 10 : 17 applications essentielles

HackerNoon Decoded: The Top 10 Countries Where HackerNoon Is the Most Active

Vous voulez gagner un concours d’écriture HackerNoon ? Voici ce que recommandent les gagnants du concours #crypto-api

Naviguer sur les eaux : développer des applications RAG de qualité production avec des lacs de données

Comment améliorer votre flux de travail par 10 : 17 applications essentielles

HackerNoon Decoded: The Top 10 Countries Where HackerNoon Is the Most Active

Vous voulez gagner un concours d’écriture HackerNoon ? Voici ce que recommandent les gagnants du concours #crypto-api

Light-Mode

Classic

Newspaper

Minty

Dark-Mode

Neon Noir

Minty

HN StartUps