diff --git a/conf.yaml b/conf.yaml
index 71e9cf5e8d983..126d7b24921e7 100644
--- a/conf.yaml
+++ b/conf.yaml
@@ -942,6 +942,7 @@ contents:
                 tags:       APM Java Agent/Reference
                 subject:    APM
                 chunk:      1
+                asciidoctor: true
                 sources:
                   -
                     repo:   apm-agent-java
diff --git a/doc_build_aliases.sh b/doc_build_aliases.sh
index f31c9c8ff413a..caa7b3b252ef3 100644
--- a/doc_build_aliases.sh
+++ b/doc_build_aliases.sh
@@ -88,7 +88,7 @@ alias docbldamp='$GIT_HOME/docs/build_docs.pl --doc $GIT_HOME/apm-agent-python/d
 
 alias docbldamry='$GIT_HOME/docs/build_docs.pl --doc $GIT_HOME/apm-agent-ruby/docs/index.asciidoc --chunk 1'
 
-alias docbldamj='$GIT_HOME/docs/build_docs.pl --doc $GIT_HOME/apm-agent-java/docs/index.asciidoc --chunk 1'
+alias docbldamj='$GIT_HOME/docs/build_docs --asciidoctor --doc $GIT_HOME/apm-agent-java/docs/index.asciidoc --chunk 1'
 
 alias docbldamjs='$GIT_HOME/docs/build_docs.pl --doc $GIT_HOME/apm-agent-js-base/docs/index.asciidoc --chunk 1'