Install on macOS

Homebrew

Install

You can use Homebrew, the macOS package manager, to install Asciidoctor. If you don’t have Homebrew on your computer, complete the installation instructions first.

Once Homebrew is installed, you’re ready to install the asciidoctor gem. Open a terminal and type:

$ brew install asciidoctor

Homebrew installs the asciidoctor gem into an exclusive prefix that’s independent of system gems.

If the gem installed successfully, Asciidoctor’s command line interface (CLI) will be available on your PATH. To confirm that Asciidoctor is available, execute:

$ asciidoctor --version

You should see information about the Asciidoctor version and your Ruby environment printed in the terminal.

Asciidoctor 2.0.16 [https://asciidoctor.org]
Runtime Environment (ruby 3.0.2p107 [x86_64-linux]) (lc:UTF-8 fs:UTF-8 in:- ex:UTF-8)

Upgrade

To upgrade the gem, open a terminal and type:

$ brew update
$ brew upgrade asciidoctor

Uninstall

To uninstall the gem, open a terminal and type:

$ brew uninstall asciidoctor

MacPorts

You can also use MacPorts, another package manager for macOS, to install Asciidoctor. If you don’t have MacPorts on your computer, complete the installation instructions first.

Once MacPorts is installed, you’re ready to install the asciidoctor gem via the Asciidoctor port. Open a terminal and type:

$ sudo port install asciidoctor

If the gem installed successfully, Asciidoctor’s command line interface (CLI) will be available on your PATH. To confirm that Asciidoctor is available, execute:

$ asciidoctor --version

You should see information about the Asciidoctor version and your Ruby environment printed in the terminal.

Asciidoctor 2.0.16 [https://asciidoctor.org]
Runtime Environment (ruby 3.0.2p107 [x86_64-linux]) (lc:UTF-8 fs:UTF-8 in:- ex:UTF-8)

Upgrade

To upgrade the gem, open a terminal and type:

$ sudo port selfupdate
$ sudo port upgrade asciidoctor

Uninstall

To uninstall the gem, open a terminal and type:

$ sudo port uninstall asciidoctor