# Install asciidoctorj with Homebrew, chocolatey, MacPorts, Nix, scoop Java wrapper and bindings for Asciidoctor. Version 3.0.1 via Homebrew; verified 2026-06-22. Also installable with nix: nix profile install nixpkgs#asciidoctorj. ## Install ```sh sudo av install brew:asciidoctorj ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install asciidoctorj ``` Evidence: local Homebrew formula metadata - MacPorts (94%): ```sh sudo port install asciidoctorj ``` Evidence: MacPorts ports tree: textproc/asciidoctorj/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1 ### Linux - Nix (92%): ```sh nix profile install nixpkgs#asciidoctorj ``` Evidence: nixpkgs package indexes: pkgs/by-name/as/asciidoctorj/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 ### Windows - Chocolatey (92%): ```sh choco install asciidoctorj ``` Evidence: Chocolatey community package catalog: asciidoctorj from http://community.chocolatey.org/api/v2/Packages?$filter=IsLatestVersion&$select=Id&$top=1000&$skiptoken='11','another-redis-desktop-manager' - Scoop (92%): ```sh scoop install main/asciidoctorj ``` Evidence: Scoop official bucket manifest trees: bucket/asciidoctorj.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1 ## Package facts - **Package key:** brew:asciidoctorj - **Package manager:** Homebrew - **Version:** 3.0.1 - **Source summary:** Java wrapper and bindings for Asciidoctor - **Homepage:** - **Last updated:** 2026-06-22T14:02:46-07:00 - **Generated:** 2026-08-03T19:37:03+00:00 ## Executables - asciidoctorj (alias) ## Install behavior - Bottle: not available ## Freshness - Page generated: 2026-08-03 - Package-manager version: 3.0.1 ## Project history and usage AsciidoctorJ is the official JVM integration for Asciidoctor, letting Java and other JVM programs run Asciidoctor and inspect parsed AsciiDoc documents. For package users it is both a command-line converter and a Maven Central artifact family, making AsciiDoc processing available in Java build systems without requiring a separate Ruby toolchain. ### Project history The project sits inside the Asciidoctor ecosystem as the Java binding layer for the Ruby Asciidoctor processor. Its official README describes AsciidoctorJ as the official library for running Asciidoctor on the JVM and credits Alex Soto, Dan Allen, and Robert Panzer as maintainers/authors on the README header. AsciidoctorJ's early public release line was already formalized by 2014: the repository has an annotated `asciidoctorj-1.5.0` tag dated 2014-08-17, and the README notes that the Maven artifactId changed to `asciidoctorj` starting in 1.5.0. The project later kept a long 2.x series and published 3.0.0 in 2024, continuing the JVM-facing role while the wider Asciidoctor documentation moved to docs.asciidoctor.org. ### Adoption history AsciidoctorJ's adoption path is centered on Java build tooling. The README documents Maven, Gradle, SBT, and Leiningen dependency examples and says the artifacts are published to Maven Central, which made it useful for documentation pipelines embedded in JVM projects. Package-manager adoption followed the same developer-tool pattern: the input package facts list Homebrew, Chocolatey, MacPorts, Nix, and Scoop packages. That spread matters because AsciidoctorJ is often installed as a CLI by documentation authors even when the underlying attraction is JVM integration. ### How it is used The CLI use case is converting AsciiDoc files from the shell, for example running `asciidoctorj -b pdf README.adoc`. The library use case is declaring `org.asciidoctor:asciidoctorj` in a JVM build and invoking Asciidoctor conversion or AST inspection from Java or another JVM language. ### Why package nerds care AsciidoctorJ is interesting to package nerds because it packages a Ruby-origin documentation processor for the JVM world. It bridges language ecosystems: Ruby Asciidoctor behavior, Java dependency management, build plugins, and a cross-platform command-line distribution all meet in one package. ### Timeline - 2013: GitHub repository created for Java bindings for Asciidoctor. - 2014: `asciidoctorj-1.5.0` annotated tag published; README notes the artifactId changed to `asciidoctorj` in 1.5.0. - 2021: 2.5.0 release published. - 2024: 3.0.0 release published. ### Related projects - Asciidoctor is the upstream AsciiDoc processor that AsciidoctorJ runs on the JVM. - Asciidoctor Maven and Gradle integrations are documented as build-system paths for using AsciidoctorJ. ### Sources - - - - source_facts.package-manager ## Security Notes narrow executable package without higher-risk signals. - **Geiger risk:** green / low - narrow executable package without higher-risk signals ## Other Package-Manager Records - Nix - asciidoctorj: normalized package name match | nixpkgs package indexes: pkgs/by-name/as/asciidoctorj/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 - MacPorts - asciidoctorj: normalized package name match | MacPorts ports tree: textproc/asciidoctorj/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1 - Chocolatey - asciidoctorj: normalized package name match | Chocolatey community package catalog: asciidoctorj from http://community.chocolatey.org/api/v2/Packages?$filter=IsLatestVersion&$select=Id&$top=1000&$skiptoken='11','another-redis-desktop-manager' - Scoop - main/asciidoctorj: normalized package name match | Scoop official bucket manifest trees: bucket/asciidoctorj.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1 ## Combined YAML source View the package source record on GitHub. [combined/asciidoctorj.yml](https://github.com/mxcl/pkgdb/blob/main/combined/asciidoctorj.yml) ## Sources - pkg.so package database - Geiger risk classifier - curated package history - pkgdb category and tag curation - external package-manager database matches - cross-ecosystem install command graph