Asciidoctor is a fast text processor and publishing toolchain for converting AsciiDoc content to HTML, DocBook, and other formats. Asciidoctor is packaged as a RubyGem and published to RubyGems.org. The gem is also included in several Linux distributions, including Fedora, Debian, Ubuntu, and Alpine. Asciidoctor is open source, hosted on GitHub and released under the MIT license.
Asciidoctor reads content written in plain text, as shown in the panel on the left in the image below, and converts it to HTML5, as shown rendered in the right panel. Asciidoctor adds a default stylesheet to the HTML5 document, as shown, to provide a pleasant out-of-the-box experience.
Asciidoctor reads and parses text written in the AsciiDoc syntax, then feeds the parse tree into a set of built-in templates to produce HTML, PDF, DocBook, man page, and other output formats. You have the option of writing your own converter or loading Tilt-supported templates to customize the generated output or produce alternative formats. Asciidoctor also offers a responsive theme based on Foundation to style the HTML5 output.
You can run Asciidoctor on the JVM using JRuby. To invoke the Asciidoctor API directly from Java and other JVM languages, use AsciidoctorJ. There are plugins available that integrate Asciidoctor into Apache Maven, Gradle, or Javadoc builds.