Asciidoctor User Manual

Using the Asciidoctor doclet, you can write your Javadoc comments using all the features of Asciidoctor including tables, lists, code examples with syntax highlighting, and pictures.

If you want to incorporate your Javadoc into another document instead, there is an experimental doclet that exports them to AsciiDoc files. See the exportdoclet project and the related discussion thread for details.