# Install asciidoctorj with Homebrew, chocolatey, MacPorts, Nix, scoop Java wrapper and bindings for Asciidoctor. Version 3.0.1 via Homebrew; verified 2026-06-22. ## 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','ansicon' - 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 - **Package manager page:** - **Version:** 3.0.1 - **Source summary:** Java wrapper and bindings for Asciidoctor - **Homepage:** - **Repository:** - **Upstream docs:** - **License:** Apache-2.0 - **Source archive:** - **Last updated:** 2026-06-22T14:02:46-07:00 - **Generated:** 2026-07-08T07:18:31+00:00 ## Executables - asciidoctorj (cli) - asciidoctorj (alias) ## Dependencies - openjdk ## Install behavior - Post-install hook: not defined - Bottle: available on all ## Freshness - Page generated: 2026-07-08 - Package-manager version: 3.0.1 - Package-manager updated: 2026-06-22 - Local data: ok - Upstream repository: https://github.com/asciidoctor/asciidoctorj - info: No cached GitHub release or tag data was available. ## 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 ## Source Database Details - **Source Database:** Homebrew formula API - **Tap:** homebrew/core - **Full Name:** asciidoctorj - **Version Scheme:** 0 - **Revision:** 0 - **Bottle Stable Root URL:** - **Deprecated:** no - **Disabled:** no - **Keg Only:** no - **URL Keys:** stable ## 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','ansicon' - 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 ## Related links - [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family. - [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata. - [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata. - [Developer build packages](https://www.automicvault.com/pkg/developer-build-tools/) - Matched build, compiler, generator, or developer workflow metadata. - [openjdk](https://www.automicvault.com/pkg/brew/openjdk/) - Runtime dependency declared by Homebrew. - [asciidoctor](https://www.automicvault.com/pkg/brew/asciidoctor/) - Shares av.db curated category or tags: asciidoc, cli, developer-tools, documentation. - [jbake](https://www.automicvault.com/pkg/brew/jbake/) - Shares av.db curated category or tags: asciidoc, cli, developer-tools, java. - [action-docs](https://www.automicvault.com/pkg/brew/action-docs/) - Shares av.db curated category or tags: cli, developer-tools, documentation. - [adr-tools](https://www.automicvault.com/pkg/brew/adr-tools/) - Shares av.db curated category or tags: cli, developer-tools, documentation. - [adr-viewer](https://www.automicvault.com/pkg/brew/adr-viewer/) - Shares av.db curated category or tags: cli, developer-tools, documentation. - [amdatu-bootstrap](https://www.automicvault.com/pkg/brew/amdatu-bootstrap/) - Shares av.db curated category or tags: cli, developer-tools, java. - [ant](https://www.automicvault.com/pkg/brew/ant/) - Shares av.db curated category or tags: cli, developer-tools, java. - [antlr](https://www.automicvault.com/pkg/brew/antlr/) - Shares av.db curated category or tags: cli, developer-tools, java. - [bundletool](https://www.automicvault.com/pkg/brew/bundletool/) - Both packages touch the same language runtime or ecosystem. Shared terms: cli, developer, developer-tools, java, openjdk. - [dex2jar](https://www.automicvault.com/pkg/brew/dex2jar/) - Both packages touch the same language runtime or ecosystem. Shared terms: cli, developer, developer-tools, java, openjdk. - [fernflower](https://www.automicvault.com/pkg/brew/fernflower/) - Both packages touch the same language runtime or ecosystem. Shared terms: cli, developer, developer-tools, java, openjdk. ## Combined YAML source View the package source record on GitHub. [combined/asciidoctorj.yml](https://github.com/automic-vault/db/blob/main/combined/asciidoctorj.yml) ## Sources - Nucleus package database - Geiger risk classifier - package-page enrichment - curated package history - package version freshness - av.db category and tag curation - package relationship graph - external package-manager database matches - cross-ecosystem install command graph