O asciidoctor-java-integration é o meio oficial de usar o Asciidoctor para renderizar toda a sua documentação AsciiDoc usando Java em vez de Ruby.

Instalação

É um jar simples e não requer nenhum tratamento especial, basta adicionar o jar ao classpath.

<dependencies>
  <dependency>
    <groupId>org.asciidoctor</groupId>
    <artifactId>asciidoctor-java-integration</artifactId>
    <version>${asciidoctor.version}</version>                   
  </dependency>
</dependencies>

Uso

e agora você está pronto para renderizar documentos asciidoc para qualquer backend suportado pelo Asciidoctor.

Por exemplo, você pode renderizar de uma String formatada em AsciiDoc para uma String em HTML .

import static org.asciidoctor.Asciidoctor.Factory.create;
import org.asciidoctor.Asciidoctor;

Asciidoctor asciidoctor = create();

String rendered = asciidoctor.render("*This* is it.",  Collections.EMPTY_MAP);
System.out.println(rendered);

Ou também de um arquivo.

String rendered = asciidoctor.renderFile("docs/sample.adoc", Collections.EMPTY_MAP);
System.out.println(rendered);

Finalmente, você pode definir as opções e atributos suportados pelo Asciidoctor :

import static org.asciidoctor.AttributesBuilder.attributes;
import static org.asciidoctor.OptionsBuilder.options;

//docs/sample.xml file is generated by using next options
Map<String, Object> attributes = attributes().backend("docbook").asMap();
Map<String, Object> options = options().inPlace(true).attributes(attributes).asMap();

asciidoctor.renderFile("docs/sample.adoc", options);

Agora você não tem desculpa para não usar o Asciidoctor porque ele não é compatível com Java.

Também dê uma olhada em:

• Plugin Asciidoctor Maven
• Plugin Asciidoctor Gradle

Continuamos aprendendo,
Alex.