About Asciidoctor
Asciidoctor is a text processor and publishing toolchain written in Ruby. It parses AsciiDoc content into a document model and converts it to output formats including HTML 5, DocBook 5, manual pages, PDF, and EPUB 3. The tool is open source and designed for speed.
Asciidoctor provides built-in converters for HTML 5, DocBook 5, and man pages by default, with additional converters for PDF and EPUB 3 available as separate gems. It includes an out-of-the-box HTML experience with a default stylesheet and integrations for icons, source highlighting, and STEM processing. The project also has an ecosystem of extensions, converters, build plugins, and tools.
Key features
- Converts AsciiDoc to HTML5, DocBook 5, manual pages, PDF, and EPUB 3
- Built-in converters for HTML5, DocBook 5, and man pages
- Default stylesheet and integrations for Font Awesome, highlight.js, Rouge, Pygments, and MathJax
- Can run on Ruby, JVM (via AsciidoctorJ), or JavaScript environments (via Asciidoctor.js)
- Ecosystem of extensions, converters, build plugins, and tools
Good fit for
- Authoring and publishing technical documentation
- Converting AsciiDoc content to web or print formats
Asciidoctor: questions and answers
- What is Asciidoctor used for?
- Asciidoctor is a fast, open source, Ruby-based text processor that parses AsciiDoc content and converts it to formats such as HTML5, DocBook 5, manual pages, PDF, and EPUB 3. It is a good fit for authoring and publishing technical documentation, and converting AsciiDoc content to web or print formats.
- Is Asciidoctor open source?
- Yes. Asciidoctor is open source under a custom licence. Its source code is on GitHub at asciidoctor/asciidoctor and is written mainly in Ruby.
- Is Asciidoctor free?
- Yes. Asciidoctor is open source, so the software itself is free to use under the terms of its own licence.
- Can I self-host Asciidoctor?
- Yes. Asciidoctor can be self-hosted on your own server or infrastructure.
- What is Asciidoctor an alternative to?
- Asciidoctor is an open-source alternative to Paligo. Other open-source alternatives to Paligo include GitBook, Sphinx and Readthedocs.org.
- Is Asciidoctor actively maintained?
- Yes. The most recent commit to Asciidoctor was on 9 November 2026, and the latest release is v2.0.26, published on 24 October 2025. The project has 5.2k stars on GitHub, with 4 added in the last 30 days.
Open-source alternatives to Asciidoctor
See all
GitBook
Docs & Wikis
The open source frontend for GitBook doc sites
GPL-3.0vs GitBook★ 29k
Sphinx
Docs & Wikis
The Sphinx documentation generator
OSSvs Document360★ 8.1k
Readthedocs.org
Docs & Wikis
The source code that powers readthedocs.org
MITvs GitBook★ 8.4k
Gramax
Docs & Wikis
Embrace a docs-as-code approach to build, version, and publish Git-driven documentation si
GPL-3.0vs GitBook★ 625

Paligo