Asciidoctor

Open source

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.

Open-source alternative to

asciidoctor.org
Asciidoctor homepage screenshot
GitHub stars
5.2k
Last 30 days
+4(+0%)
Last commit
3 days ago
Repository age
14 years
Version
v2.0.26
Licence
Custom
Self-hosted
Yes

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
Built with
Ruby tools
Tags
asciidoc
text-processor
publishing
ruby
documentation
converter

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

SaaS alternatives to Asciidoctor

See all