Asciidoctor
A fast text processor and publishing toolchain for AsciiDoc.
Asciidoctor converts AsciiDoc source into HTML5, DocBook, EPUB, PDF, and several other formats. AsciiDoc is a richer markup language than Markdown — built-in tables, admonitions, includes, attribute substitution, and structured cross-references — that is well suited for technical books and long-form documentation. The GitHub renderer for .adoc files uses Asciidoctor.
The project is a Ruby reimplementation of the original Python-based AsciiDoc, redesigned around a faster parser and a more extensible converter framework. Asciidoctor.js (a JavaScript build of the same engine via Opal) lets Asciidoctor run in the browser or on Node.js.
Dan Allen and Sarah White lead the project. Asciidoctor is the documentation tool of choice for several large open-source projects — Spring, Camel, Hibernate, and many other JVM ecosystem projects — and is the engine behind the Antora multi- repository documentation site generator widely used in the same community.
Install
gem install asciidoctor Or: Debian/Ubuntu: sudo apt install asciidoctor Fedora/RHEL: sudo dnf install asciidoctor Arch: sudo pacman -S asciidoctor
Authors
- Dan Allen, Sarah White (lead maintainers)
- Asciidoctor contributors