Asciidoctor
Ruby text processor that converts AsciiDoc source into HTML 5, DocBook 5, man pages and other output formats.
Asciidoctor is the Ruby processor for AsciiDoc, the markup language. It reads AsciiDoc source and converts it to output formats such as HTML 5, DocBook 5 and man pages. PDF and EPUB 3 output come from separate converter gems. It is the successor to AsciiDoc.py.
Asciidoctor is installed as a gem from RubyGems, through Bundler, a Linux distribution package, Homebrew or MacPorts, or the Docker image named on the install page. The same language is processed outside Ruby by Asciidoctor.js, for JavaScript, and AsciidoctorJ, for the JVM. Both are separate projects.
Worth knowing
Asciidoctor itself requires a Ruby implementation: CRuby, JRuby or TruffleRuby, in the version ranges the homepage lists.
Identity
Rendering and deploy
- Install with
- gem install, Bundler, Linux distribution packages, Homebrew or MacPorts, or the Docker image4
Releases
Adoption
Sources
- 2026-10-23: links, Written in, Categories, Runtime, Minimum runtime
asciidoctor.org/ - 2026-10-23: links, GitHub stars
api.github.com/repos/asciidoctor/asciidoctor - 2026-10-23: Maintainer, License, License model
raw.githubusercontent.com/asciidoctor/asciidoctor/main/LICENSE - 2026-10-23: Install with
docs.asciidoctor.org/asciidoctor/latest/install/ - 2026-10-23: First release
rubygems.org/api/v1/versions/asciidoctor.json - 2026-10-23: Current major version, Last release
api.github.com/repos/asciidoctor/asciidoctor/releases - 2026-10-23: Contributors
api.github.com/repos/asciidoctor/asciidoctor/contributors?per_page=1 - 2026-10-25: Sites using it (HTTP Archive)
cdn.httparchive.org/v1/technologies - 2026-10-25: Dependent repositories, Dependent packages
packages.ecosyste.ms/api/v1/registries/rubygems.org/packages/asciidoctor