Asciidoctor Deep Dive

AsciiDoc is a markup language for documentation. Asciidoctor is a popular implementation of a rendering engine for AsciiDoc.

Conventions allow you to add formatting to your text and structure it with tables, lists and chapters. You can keep your AsciiDoc files in a versioning system like Git to track all changes. Many companies and open source projects use it to write their technical documentation.

My talk “Asciidoctor Deep Dive” shows you the details on how to tackle corner cases in formatting. The second part of the talk shows you how to create PDF files with the PDF extension of Asciidoctor.

The slides are in English. You find a recording in English and German below. For the online news channel heise.developer I’ve written a German blog post “Documentation as Code mit Asciidoctor”.

An example repository is available on GitHub: https://github.com/ahus1/asciidoctor-deepdive

If you want to learn more about the topic, I’ve recorded a Udemy course “Technical Writing with AsciiDoc and IntelliJ IDEA”.

There’s also Hubert Sablonnière’s talk at Devoxx 2017: “Documentation as code (explained to my dad)”.