# Install asciidoc with Homebrew, apk, apt, dnf, MacPorts, Nix, pacman, zypper Formatter/translator for text files to numerous formats. Version 10.2.1 via Homebrew; verified from local package data. ## Install ```sh sudo av install brew:asciidoc ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install asciidoc ``` Evidence: local Homebrew formula metadata - MacPorts (94%): ```sh sudo port install asciidoc ``` Evidence: MacPorts ports tree: textproc/asciidoc/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1 ### Linux - apk (92%): ```sh sudo apk add asciidoc ``` Evidence: Alpine Linux edge package indexes: asciidoc from https://dl-cdn.alpinelinux.org/alpine/edge/main/x86_64/APKINDEX.tar.gz - Debian apt (92%): ```sh sudo apt install asciidoc ``` Evidence: Debian stable package indexes: asciidoc from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz - dnf (92%): ```sh sudo dnf install asciidoc ``` Evidence: Fedora Rawhide package metadata: asciidoc from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst - Nix (92%): ```sh nix profile install nixpkgs#asciidoc ``` Evidence: nixpkgs package indexes: pkgs/by-name/as/asciidoc/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 - pacman (92%): ```sh sudo pacman -S asciidoc ``` Evidence: Arch Linux sync databases: asciidoc from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz - zypper (92%): ```sh sudo zypper install asciidoc ``` Evidence: openSUSE Tumbleweed package metadata: asciidoc from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst ## Package facts - **Package key:** brew:asciidoc - **Package manager:** Homebrew - **Package manager page:** - **Version:** 10.2.1 - **Source summary:** Formatter/translator for text files to numerous formats - **Homepage:** - **Repository:** - **Upstream docs:** - **License:** GPL-2.0-or-later - **Source archive:** - **Generated:** 2026-07-08T07:18:31+00:00 ## Executables - a2x (cli) - asciidoc (cli) - a2x (alias) - asciidoc (alias) ## Dependencies - docbook - python@3.14 - source-highlight ## Uses from macOS - libxml2 ## Install behavior - Post-install hook: not defined - Caveats: If you intend to process AsciiDoc files through an XML stage (such as a2x for manpage generation) you need to add something like: export XML_CATALOG_FILES=$HOMEBREW_PREFIX/etc/xml/catalog to your shell rc file so that xmllint can find AsciiDoc's catalog files. See `man 1 xmllint' for more. - Bottle: available on all ## Freshness - Page generated: 2026-07-08 - Package-manager version: 10.2.1 - Local data: ok - Upstream repository: https://asciidoc-py.github.io/ - info: No package-manager update timestamp was available. - info: Release/tag comparison is only available for GitHub repositories. ## Project history and usage The Homebrew `asciidoc` formula packages AsciiDoc.py, the legacy Python processor for the AsciiDoc lightweight markup language. The language began as Stuart Rackham's shorthand for DocBook, while the current AsciiDoc.py site now explicitly distinguishes the legacy processor from the modern AsciiDoc specification. ### Project history The official Asciidoctor history records that Stuart Rackham first conceived AsciiDoc in 2002 as a shorthand format for DocBook and launched both the language and processor as the AsciiDoc.py project. The first public AsciiDoc.py 1.0 release, SourceForge registration, and first website publication all happened on 2002-11-25. AsciiDoc.py evolved for roughly a decade as the original processor. The official timeline records a move from SourceForge-era hosting through Google Code and then, in December 2013, transfer of the source repository to the asciidoc organization on GitHub. The AsciiDoc.py homepage describes it as highly configurable, with source syntax and backend output markups customizable through configuration files. The later Python package line modernized the old processor. The official changelog records Python 3.5+ support in version 9.0.0 in 2020, a 10.0.0 rewrite into a proper Python package installable with `pip install asciidoc` in 2021, and version 10.2.1 in July 2024. ### Adoption history AsciiDoc.py spread because it made DocBook-oriented publishing possible from plain text using `asciidoc` and the `a2x` wrapper. The official homepage shows examples for HTML, XHTML, DocBook, EPUB, PDF, slides, websites, and Unix man pages, and the install page lists distro packaging in Fedora, Debian/Ubuntu, and Homebrew. Its role changed after Asciidoctor appeared. The official history says Asciidoctor became AsciiDoc.py's successor after GitHub disabled AsciiDoc rendering in January 2013 for security concerns and then re-enabled rendering with Asciidoctor. The AsciiDoc.py homepage now recommends using a modern processor unless the AsciiDoc.py toolchain is specifically required. ### How it is used Package users install `asciidoc` and `a2x` to translate `.txt` or `.adoc` sources into HTML, DocBook, man pages, EPUB, PDF, and related outputs. The user guide describes AsciiDoc as lightweight, consisting of scripts plus configuration files, with backend plugins and themes extending output generation. ### Why package nerds care AsciiDoc.py is historically important because it is the original implementation that made AsciiDoc a package-manager staple. It is also a useful case study in language/tool split: the `asciidoc` package name preserves the old Python processor even as the language specification and modern processing ecosystem moved toward Asciidoctor and the Eclipse AsciiDoc Working Group. ### Timeline - 2002-11-25: First public release of AsciiDoc.py 1.0 by Stuart Rackham. - 2007-10-23: AsciiDoc.py source repository converted to Mercurial and transferred to Google Code. - 2013-12-21: AsciiDoc.py source repository converted to git and transferred to the asciidoc GitHub organization. - 2020-06-02: AsciiDoc.py 9.0.0 ports the processor to Python 3.5+. - 2021-10-16: AsciiDoc.py 10.0.0 becomes a proper Python package installable from PyPI. - 2024-07-16: AsciiDoc.py 10.2.1 released. ### Related projects - Asciidoctor is the Ruby successor and current reference implementation for the AsciiDoc language. - a2x is the AsciiDoc.py toolchain wrapper for post-processing DocBook output into formats such as PDF and EPUB. - The Eclipse AsciiDoc Working Group governs the modern AsciiDoc language direction. ### Sources - - - - - ## 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:** asciidoc - **Version Scheme:** 0 - **Revision:** 1 - **Head Version:** HEAD - **Bottle Stable Root URL:** - **Deprecated:** no - **Disabled:** no - **Keg Only:** no - **URL Keys:** head, stable ## Other Package-Manager Records - Debian apt - asciidoc - 10.2.1-1: normalized package name match | Debian stable package indexes: asciidoc from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | Highly configurable text format for writing documentation | https://asciidoc.org - Debian apt - asciidoc-base - 10.2.1-1: normalized package name match | Debian stable package indexes: asciidoc-base from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | Minimal version of asciidoc not suitable for pdf | https://asciidoc.org - Debian apt - asciidoc-common - 10.2.1-1: normalized package name match | Debian stable package indexes: asciidoc-common from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | Basic data and configuration files for asciidoc | https://asciidoc.org - Debian apt - asciidoc-dblatex - 10.2.1-1: normalized package name match | Debian stable package indexes: asciidoc-dblatex from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | Asciidoc package including dblatex dependencies | https://asciidoc.org - Debian apt - asciidoc-fop - 10.2.1-1: normalized package name match | Debian stable package indexes: asciidoc-fop from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | Asciidoc package including fop dependencies | https://asciidoc.org - Debian apt - asciidoc-tests - 10.2.1-1: normalized package name match | Debian stable package indexes: asciidoc-tests from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | Test framework for asciidoc | https://asciidoc.org - Nix - asciidoc: normalized package name match | nixpkgs package indexes: pkgs/by-name/as/asciidoc/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 - Ubuntu apt - asciidoc - 10.2.0-2: normalized package name match | Ubuntu 24.04 LTS package indexes: asciidoc from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | Highly configurable text format for writing documentation | https://asciidoc.org - Ubuntu apt - asciidoc-base - 10.2.0-2: normalized package name match | Ubuntu 24.04 LTS package indexes: asciidoc-base from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | Minimal version of asciidoc not suitable for pdf | https://asciidoc.org - Ubuntu apt - asciidoc-common - 10.2.0-2: normalized package name match | Ubuntu 24.04 LTS package indexes: asciidoc-common from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | Basic data and configuration files for asciidoc | https://asciidoc.org - Ubuntu apt - asciidoc-dblatex - 10.2.0-2: normalized package name match | Ubuntu 24.04 LTS package indexes: asciidoc-dblatex from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | Asciidoc package including dblatex dependencies | https://asciidoc.org - Ubuntu apt - asciidoc-fop - 10.2.0-2: normalized package name match | Ubuntu 24.04 LTS package indexes: asciidoc-fop from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | Asciidoc package including fop dependencies | https://asciidoc.org - Ubuntu apt - asciidoc-tests - 10.2.0-2: normalized package name match | Ubuntu 24.04 LTS package indexes: asciidoc-tests from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | Test framework for asciidoc | https://asciidoc.org - apk - asciidoc - 10.2.1-r1: normalized package name match | Alpine Linux edge package indexes: asciidoc from https://dl-cdn.alpinelinux.org/alpine/edge/main/x86_64/APKINDEX.tar.gz | Text based documentation | https://asciidoc.org/ - apk - asciidoc-doc - 10.2.1-r1: normalized package name match | Alpine Linux edge package indexes: asciidoc-doc from https://dl-cdn.alpinelinux.org/alpine/edge/main/x86_64/APKINDEX.tar.gz | Text based documentation (documentation) | https://asciidoc.org/ - apk - asciidoc-pyc - 10.2.1-r1: normalized package name match | Alpine Linux edge package indexes: asciidoc-pyc from https://dl-cdn.alpinelinux.org/alpine/edge/main/x86_64/APKINDEX.tar.gz | Precompiled Python bytecode for asciidoc | https://asciidoc.org/ ## 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. - [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata. - [docbook](https://www.automicvault.com/pkg/brew/docbook/) - Runtime dependency declared by Homebrew. - [python@3.14](https://www.automicvault.com/pkg/brew/python-3-14/) - Runtime dependency declared by Homebrew. - [source-highlight](https://www.automicvault.com/pkg/brew/source-highlight/) - Runtime dependency declared by Homebrew. - [mark](https://www.automicvault.com/pkg/brew/mark/) - Shares av.db curated category or tags: cli, documentation, productivity. - [markdown-toc](https://www.automicvault.com/pkg/brew/markdown-toc/) - Shares av.db curated category or tags: cli, documentation, productivity. - [aspell](https://www.automicvault.com/pkg/brew/aspell/) - Shares av.db curated category or tags: cli, productivity, text-processing. - [bibclean](https://www.automicvault.com/pkg/brew/bibclean/) - Shares av.db curated category or tags: cli, formatter, productivity. - [bookloupe](https://www.automicvault.com/pkg/brew/bookloupe/) - Shares av.db curated category or tags: cli, productivity, text-processing. - [extract_url](https://www.automicvault.com/pkg/brew/extract-url/) - Shares av.db curated category or tags: cli, productivity, text-processing. - [ispell](https://www.automicvault.com/pkg/brew/ispell/) - Shares av.db curated category or tags: cli, productivity, text-processing. - [latexindent](https://www.automicvault.com/pkg/brew/latexindent/) - Shares av.db curated category or tags: cli, formatter, productivity. - [beancount](https://www.automicvault.com/pkg/brew/beancount/) - Both packages touch the same language runtime or ecosystem. Shared terms: cli, files, productivity, python, python-3-14. - [liblouis](https://www.automicvault.com/pkg/brew/liblouis/) - Both packages touch the same language runtime or ecosystem. Shared terms: cli, productivity, python, python-3-14, source. ## Combined YAML source View the package source record on GitHub. [combined/asciidoc.yml](https://github.com/automic-vault/db/blob/main/combined/asciidoc.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