About Asciidoctor
Asciidoctor is an open source text processor and publishing toolchain for the AsciiDoc format. It converts AsciiDoc source into HTML 5, DocBook, man pages and other outputs.
What it does
Asciidoctor reads AsciiDoc files and converts them to the output formats you need. Built-in converters cover HTML 5, DocBook 5 and man pages, while separate gems add PDF and EPUB 3. It also has an ecosystem of extensions, converters and build plugins that help teams write and publish longer content, and it runs on Ruby, on the Java virtual machine or in JavaScript environments.
Key features
- HTML 5, DocBook and man page output
- PDF and EPUB 3 through extra gems
- Syntax highlighting for code blocks
- Math support with MathJax
- Ruby, JVM and JavaScript versions
Who it's for
Asciidoctor suits technical writers and documentation teams who need manuals, API guides or books with a clear structure. It is a good fit for projects that want one source file to produce several output formats, and for teams who prefer AsciiDoc over Markdown for longer work.
Pricing and good to know
Asciidoctor is open source and free to use. It is installed as a Ruby gem, or you can use the AsciidoctorJ or Asciidoctor.js versions in other environments. Some output formats need extra gems that you install separately, so plan your toolchain before you start a large project.
Highlights
- HTML 5, DocBook and man page output
- PDF and EPUB 3 through extra gems
- Syntax highlighting for code blocks
- Math support with MathJax
- Ruby, JVM and JavaScript versions
