On this page you can download the AsciiDoc3 files you need for installing.

Take a look here to learn more about the different ways to install AsciiDoc3.

1. GNU/Linux

Table 1. *System wide*, superuser (sudo/su/root) rights required
	`Files`	`Distro`
Generic	`Tarball: asciidoc3-3.x.y.tar.gz`	`All`
Debian	`Package: asciidoc3.deb`	`Debian, Ubuntu, Mint, …`
RedHat/openSuse	`Package: asciidoc3-x.y.z-2-noarch.rpm`	`Centos, RHEL, Leap, Tumbleweed, Fedora, …`

Table 2. *Local*, users home directory only, no superuser (sudo/su/root) rights required (*)
	`Files`	`Info`
Pip/PyPI	`PyPI Project Page: PyPI`	`See here`
Git	`GitLab AsciiDoc3`	`See here`
Generic	`Tarball: asciidoc3-3.x.y.tar.gz`	`All`

(*) Python3 should be present, of course - that’s a given in all major distros. And probably you’ll need some extra software like dblatex, Apache FOP etc…

It’s a good idea to make use of Python’s venv (virtual environment), especially when working with pip.

2. Windows

Windows user look here and/or here.

3. Current Version (Latest)

The current version (the latest) is

AsciiDoc3-3.2.3

Day of release: 2021-12-15

3.1. Tarball

You can download the distribution tarball here:

asciidoc3-3.2.3.tar.gz

GNU/Linux md5sum
f3ac9af8e067496ad061c54892506c64

You may use wget as well

wget https://asciidoc3.org/asciidoc3-3.2.3.tar.gz

3.2. Debian deb Package

Use this for Debian / Ubuntu / Lubuntu / Mint
and all Debian-based distros.

asciidoc3.deb

GNU/Linux md5sum
6fab92d90f577566fa2871ed539c7ea4

You may use wget as well

wget https://asciidoc3.org/asciidoc3.deb

3.3. RPM rpm Package

Use this for openSUSE Leap / Tumbleweed / Fedora / CentOS / RHEL
and all other rpm-based distros.

asciidoc3-3.2.3-2.noarch.rpm

GNU/Linux md5sum
a6a2821c05899e57ecfd3fb714658a02

You may use wget as well

wget https://asciidoc3.org/asciidoc3-3.2.3-2.noarch.rpm

3.4. GIT

You can download, fork or clone the repo here:
https://gitlab.com/asciidoc3/asciidoc3

Be careful:
not github.com/asciidoc/asciidoc
(this is the outdated Python2 version).

3.5. ZIP-File

You can download the distribution zip-file here:
This file contains no symlinks, this may be useful especially for Windows.

asciidoc3-3.2.0.zip

GNU/Linux md5sum
25de8e67aba8e01ff25b8c89233857b9

Windows md5sum (to check you may download the free tool here: winmd5.com)
25de8e67aba8e01ff25b8c89233857b9

Yes, the md5sums are of course identical :-)

You may use wget as well

wget https://asciidoc3.org/asciidoc3-3.2.0.zip

3.6. PyPI

The files can be found here.
Before you pip install --user asciidoc3 see the information given here.

3.7. Container (Docker, PodMan)

The image asciidoc3/asciidoc3:latest is hosted at https://hub.docker.com/u/asciidoc3.
Your system automatically downloads it when you start docker run … asciidoc3/asciidoc3:latest
Before you begin download and install asciidoc3_docker-3.2.2.tar.gz as described here.

asciidoc3_docker-3.2.2.tar.gz

wget https://asciidoc3.org/asciidoc3_docker-3.2.2.tar.gz

md5sum
62c1afed28b1a315c45f79dedff5e692

4. Install / Uninstall

For (un)installing AsciiDoc3 see here.

5. Older versions

Do not use older versions of AsciiDoc3 any more!
Do so only if you know what you are doing.

Table 3. Previous Versions of AsciiDoc3
	`Release Date`	`Link`	`md5sum`
AsciiDoc3-3.2.0	`April-16-2020`	`asciidoc3-3.2.0.tar.gz`	`7d88835ffbfe30fa896977a983f64c62`
AsciiDoc3-3.1.0	`April-04-2019`	`asciidoc3-3.1.0.tar.gz`	`12a57a365e3b6f503e1ed00d8afc5bf8`
AsciiDoc3-3.0.3	`January-07-2019`	`asciidoc3-3.0.3.tar.gz`	`6f7fc7427da4ad22ffbeabe1362e1c46`
ditto zip	`January-07-2019`	`asciidoc3-3.0.3.zip`	`69f1f5ce78c6050b27f26b01f4e32c5d`
AsciiDoc3-3.0.2	`June-15-2018`	`asciidoc3-3.0.2.tar.gz`	`2b71b4848f2a7d03569612d100626996`
AsciiDoc3-3.0.1	`May-16-2018`	`asciidoc3-3.0.1.tar.gz`	`ae15f9553d783a054ecfc356921f15fc`
AsciiDoc3-3.0.1rc	`April-13-2018`	`asciidoc3-3.0.1rc.tar.gz`	`e4d28390c36aedd3dca6e2a7b1a44075`