Automic VaultAutomic Vault

brew

Install asciidoctor with Homebrew, apk, apt, dnf, MacPorts, Nix, pacman

Text processor and publishing toolchain for AsciiDoc. Version 2.0.26 via Homebrew; verified 2026-06-13.

Install commandSecurity notes

install

Additional install commands

macOS

Homebrewverified · 100%
brew install asciidoctor

local Homebrew formula metadata

MacPortsverified · 94%
sudo port install asciidoctor

MacPorts ports tree · textproc/asciidoctor/Portfile · source: api.github.com

Linux

Alpine Linux apkverified · 92%
sudo apk add asciidoctor

Alpine Linux edge package indexes · asciidoctor · source: dl-cdn.alpinelinux.org

Debian aptverified · 92%
sudo apt install asciidoctor

Debian stable package indexes · asciidoctor · source: deb.debian.org

Fedora dnfverified · 92%
sudo dnf install rubygem-asciidoctor

Fedora Rawhide package metadata · rubygem-asciidoctor · source: dl.fedoraproject.org

Nixverified · 92%
nix profile install nixpkgs#asciidoctor

nixpkgs package indexes · pkgs/by-name/as/asciidoctor/package.nix · source: api.github.com

Arch Linux pacmanverified · 92%
sudo pacman -S asciidoctor

Arch Linux sync databases · asciidoctor · source: geo.mirror.pkgbuild.com

overview

Package summary

Text processor and publishing toolchain for AsciiDoc

Commands and aliases

  • asciidoctor
  • asciidoctor-pdf

history

Project history and usage

Asciidoctor is the Ruby-based AsciiDoc processor and publishing toolchain that became the successor to AsciiDoc.py. The official docs describe it as the current reference implementation for interpreting the AsciiDoc language and as the core of a broader ecosystem of runtimes, extensions, converters, and build plugins.

Project history

The official history traces Asciidoctor to GitHub's need to process AsciiDoc in Ruby for the GitHub application and git-scm.com documentation. GitHub was removing AsciiDoc.py-based rendering because of security and subprocess concerns, while a Ruby implementation had started for the Git website.

Nick Hengeveld made the first `asciidoc.rb` prototype commit for git-scm.com on 2012-04-03. Ryan Waldron made the first Asciidoctor commit on 2012-06-01 using that prototype lineage, and the first Asciidoctor gem release followed on 2012-06-14. In January 2013, GitHub re-enabled AsciiDoc rendering using Asciidoctor instead of AsciiDoc.py, and the project moved to the asciidoctor organization.

Dan Allen took project leadership in April 2013. The project quickly grew beyond the Ruby gem: AsciidoctorJ, Maven and Gradle plugins, Asciidoctor.js, Diagram, PDF, EPUB3, browser preview, and other tooling appeared in the official timeline. Asciidoctor 1.5.0 in 2014 introduced a modernized AsciiDoc syntax, and Asciidoctor 2.0.0 was released in March 2019.

Adoption history

Asciidoctor's adoption story is unusually explicit in the official history: it preserved GitHub repository rendering for AsciiDoc in 2013, powered git-scm.com documentation, crossed into JVM and JavaScript environments, and reached one million RubyGems downloads by November 2016 and ten million by December 2020.

The current docs describe distribution through RubyGems, Docker images, numerous Linux distribution packages, Homebrew, and MacPorts. The input package facts confirm packaging in Homebrew, Alpine, Debian, Fedora as rubygem-asciidoctor, MacPorts, Nix, Arch, and Ubuntu.

How it is used

The primary CLI is `asciidoctor`; users run `asciidoctor document.adoc` to produce HTML by default, or select converters and options for HTML5, DocBook, man pages, custom stylesheets, safe modes, extensions, and API-driven conversion. The same core can be used from Ruby, via AsciidoctorJ on the JVM, or via Asciidoctor.js in JavaScript and browser tooling.

Why package nerds care

Asciidoctor matters to package nerds because it is both a replacement for a security-sensitive legacy processor and a multi-runtime documentation platform. It touches Ruby gems, Linux distro packages, Homebrew, MacPorts, Docker, Maven, Gradle, browser extensions, and JavaScript packages, while serving as the practical reference for a markup language used to build docs, books, man pages, and websites.

Timeline

  • 2012-04-03: First asciidoc.rb prototype commit for git-scm.com.
  • 2012-06-01: First Asciidoctor commit by Ryan Waldron.
  • 2012-06-14: First Asciidoctor gem release, 0.0.1.
  • 2013-01-17: GitHub re-enables AsciiDoc rendering using Asciidoctor.
  • 2013-04-16: Project leadership transfers to Dan Allen.
  • 2013-04-25: First Asciidoctor release by Dan Allen, 0.1.2.
  • 2014-08-12: Asciidoctor 1.5.0 released with modernized AsciiDoc syntax.
  • 2016-11-26: Asciidoctor gem reaches over one million downloads.
  • 2019-03-22: Asciidoctor 2.0.0 released.
  • 2020-12-13: Asciidoctor gem reaches over ten million downloads.

Related projects

  • AsciiDoc.py is the legacy Python processor Asciidoctor succeeded.
  • AsciidoctorJ runs Asciidoctor on the JVM and underpins Maven, Gradle, and Java integrations.
  • Asciidoctor.js transpiles the Ruby source to JavaScript for browser, Node.js, and editor-preview use.
  • Asciidoctor PDF, EPUB3, Diagram, reveal.js, and related extensions expand output formats and authoring workflows.

security posture

Risk level: green

narrow executable package without higher-risk signals.

Risk classifier

green risk · low confidence · appliance

Why

  • narrow executable package without higher-risk signals

Signals

  • metadata:no-higher-risk-signals

Install behavior

  • No Homebrew post-install hook is recorded in formula metadata.
  • Homebrew bottle metadata is available for 6 platform targets.
  • Installs with 1 runtime dependencies.

Recommended review

Before unattended agent use, check whether the tool reads plaintext credentials, writes remote state, publishes artifacts, or shells out to plugins.

executables

Installed executables

CommandKindExposureNote
asciidoctorcliglobal executable
asciidoctor-pdfcliglobal executable

freshness

Version and freshness

These signals separate page generation age, package-manager activity, and upstream release comparison. Version lag is warned only when an evidence URL and comparable versions are present.

page generated2026-07-08
manager version2.0.26
manager updated2026-06-13
local dataok
upstreamcurrent
latest detectedv2.0.26

https://github.com/asciidoctor/asciidoctor

  • okNo freshness warnings were generated.

install metadata

Package metadata

Package keybrew:asciidoctor
Version2.0.26
Package managerHomebrew
Package manager pagehttps://formulae.brew.sh/formula/asciidoctor
Homepagehttps://asciidoctor.org/
Repositoryhttps://github.com/asciidoctor/asciidoctor
Upstream docshttps://asciidoctor.org/
LicenseMIT
Source archivehttps://github.com/asciidoctor/asciidoctor/archive/refs/tags/v2.0.26.tar.gz
Last updated2026-06-13T01:02:48+02:00
Pulseupdated
Dependenciesruby
Bottleavailable (on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux)
Homebrew post-installnot defined
Servicenone declared

registry facts

Source database details

Source DatabaseHomebrew formula API
Taphomebrew/core
Full Nameasciidoctor
Version Scheme0
Revision0
Bottle Stable Root URLhttps://ghcr.io/v2/homebrew/core
Deprecatedno
Disabledno
Keg Onlyno
URL Keys
  • stable

source database matches

Other package-manager records

Matches are pulled from external package-manager indexes and kept separate from local Automic Vault package links.

Debian apt95%

asciidoctor 2.0.23-1

AsciiDoc to HTML rendering for Ruby

https://asciidoctor.org

sudo apt install asciidoctor
  • Section: ruby
  • Architecture: all
  • 2 dependencies
  • normalized package name match
  • Matched by: Asciidoctor
Debian stable package indexes · deb.debian.org · Debian stable package indexes: asciidoctor from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz
Debian apt95%

asciidoctor-doc 2.0.23-1

AsciiDoc to HTML rendering for Ruby (documentation)

https://asciidoctor.org

sudo apt install asciidoctor-doc
  • Section: doc
  • Architecture: all
  • Source Package: asciidoctor
  • 1 dependencies
  • 1 optional deps
  • normalized package name match
  • Matched by: Asciidoctor
Debian stable package indexes · deb.debian.org · Debian stable package indexes: asciidoctor-doc from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz
Debian apt95%

ruby-asciidoctor 2.0.23-1

AsciiDoc to HTML rendering for Ruby (core libraries)

https://asciidoctor.org

sudo apt install ruby-asciidoctor
  • Section: ruby
  • Architecture: all
  • Source Package: asciidoctor
  • 1 dependencies
  • normalized package name match
  • Matched by: Asciidoctor
Debian stable package indexes · deb.debian.org · Debian stable package indexes: ruby-asciidoctor from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz
Nix95%

asciidoctor

nix profile install nixpkgs#asciidoctor
  • normalized package name match
  • Matched by: Asciidoctor
nixpkgs package indexes · api.github.com · nixpkgs package indexes: pkgs/by-name/as/asciidoctor/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
Ubuntu apt95%

asciidoctor 2.0.20-1

AsciiDoc to HTML rendering for Ruby

https://asciidoctor.org

sudo apt install asciidoctor
  • Section: universe/ruby
  • Architecture: all
  • 2 dependencies
  • normalized package name match
  • Matched by: Asciidoctor
Ubuntu 24.04 LTS package indexes · archive.ubuntu.com · Ubuntu 24.04 LTS package indexes: asciidoctor from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz
Ubuntu apt95%

asciidoctor-doc 2.0.20-1

AsciiDoc to HTML rendering for Ruby (documentation)

https://asciidoctor.org

sudo apt install asciidoctor-doc
  • Section: universe/doc
  • Architecture: all
  • Source Package: asciidoctor
  • 1 dependencies
  • 1 optional deps
  • normalized package name match
  • Matched by: Asciidoctor
Ubuntu 24.04 LTS package indexes · archive.ubuntu.com · Ubuntu 24.04 LTS package indexes: asciidoctor-doc from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz
Ubuntu apt95%

ruby-asciidoctor 2.0.20-1

AsciiDoc to HTML rendering for Ruby (core libraries)

https://asciidoctor.org

sudo apt install ruby-asciidoctor
  • Section: universe/ruby
  • Architecture: all
  • Source Package: asciidoctor
  • 1 dependencies
  • normalized package name match
  • Matched by: Asciidoctor
Ubuntu 24.04 LTS package indexes · archive.ubuntu.com · Ubuntu 24.04 LTS package indexes: ruby-asciidoctor from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz
apk95%

asciidoctor 2.0.26-r0

Converter for AsciiDoc to HTML5, DocBook 5 (or 4.5) and other formats

https://rubygems.org/gems/asciidoctor

sudo apk add asciidoctor
  • License: MIT
  • Architecture: x86_64
  • Source Package: asciidoctor
  • 1 dependencies
  • 1 provides
  • normalized package name match
  • Matched by: Asciidoctor
Alpine Linux edge package indexes · dl-cdn.alpinelinux.org · Alpine Linux edge package indexes: asciidoctor from https://dl-cdn.alpinelinux.org/alpine/edge/main/x86_64/APKINDEX.tar.gz
dnf95%

rubygem-asciidoctor 2.0.26-2.fc44

A fast, open source AsciiDoc implementation in Ruby

https://asciidoctor.org

sudo dnf install rubygem-asciidoctor
  • License: MIT
  • Category: Unspecified
  • Architecture: noarch
  • Source Package: rubygem-asciidoctor
  • 3 dependencies
  • 3 provides
  • normalized package name match
  • Matched by: Asciidoctor
Fedora Rawhide package metadata · dl.fedoraproject.org · Fedora Rawhide package metadata: rubygem-asciidoctor from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst
pacman95%

asciidoctor 2.0.26-1

An implementation of AsciiDoc in Ruby

https://asciidoctor.org

sudo pacman -S asciidoctor
  • License: MIT
  • Architecture: any
  • 1 dependencies
  • normalized package name match
  • Matched by: Asciidoctor
Arch Linux sync databases · geo.mirror.pkgbuild.com · Arch Linux sync databases: asciidoctor from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz
MacPorts95%

asciidoctor

sudo port install asciidoctor
  • normalized package name match
  • Matched by: Asciidoctor
MacPorts ports tree · api.github.com · MacPorts ports tree: textproc/asciidoctor/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1
pacman92%

asciidoctor-pdf 2.3.24-1

A native PDF converter for AsciiDoc based on Asciidoctor and Prawn

https://github.com/asciidoctor/asciidoctor-pdf

sudo pacman -S asciidoctor-pdf
  • License: MIT
  • Architecture: any
  • 10 dependencies
  • 1 optional deps
  • installed executable or alias match
  • Matched by: Asciidoctor Pdf
Arch Linux sync databases · geo.mirror.pkgbuild.com · Arch Linux sync databases: asciidoctor-pdf from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz

package graph

Links come from deterministic package relationships, av.db category and tag curation, ecosystem matches, and package hub membership.

Related tools

  • rubyRuntime dependency declared by Homebrew.
  • asciidoctorSame normalized package name appears in another local ecosystem. Shared terms: asciidoc, asciidoctor, processor, ruby.

Same workflow

  • asciidoctorjShares av.db curated category or tags: asciidoc, cli, developer-tools, documentation.
  • action-docsShares av.db curated category or tags: cli, developer-tools, documentation.
  • adr-toolsShares av.db curated category or tags: cli, developer-tools, documentation.
  • adr-viewerShares av.db curated category or tags: cli, developer-tools, documentation.
  • cargo-docsetShares av.db curated category or tags: cli, developer-tools, documentation.
  • cheatShares av.db curated category or tags: cli, developer-tools, documentation.
  • asciidoctorSame normalized package name in another local ecosystem.

source trail

Generated from repository data

This page is generated by av-web from the private package SQLite artifact built by scripts/generate-pkg-sqlite.py.

Used sources

  • Geiger risk classifier
  • Nucleus package database
  • av.db category and tag curation
  • cross-ecosystem install command graph
  • curated package history
  • external package-manager database matches
  • package relationship graph
  • package version freshness
  • package-page enrichment