Text based document generation using Python 3

»Home  »User Guide  »Blog  »Quickstart  »Download  »Install  »PyPI  »Docker  »Windows  »Cheatsheet  »Release Notes  »Contact / Donate  »Imprint / Impressum / Datenschutz / Privacy

AsciiDoc3-3.2.2 is here!

  • Runs in a container! (Docker; Podman)

  • Make it much easier for Windows users!

  • Bugfixes

  • More example/template files

  • At this moment there is no reason to update to this version for deb/rpm/tarball/pypi-users.

Note AsciiDoc3-3.2.1 is a bugfix release only regarding PyPI: in some cases, and when not using venv, asciidoc3_postinstall on Windows (and only on Windows) fails.
GNU/Linux systems are not affected, so the deb/rpm/gz files show version 3.2.0.

1. Current version

1.1. Tarball

The current version of AsciiDoc3 is


Day of release: 2020-04-16

1.2. rpm / deb Packages


Day of release: 2020-04-16

1.3. PyPI

AsciiDoc3 can be found at


Day of release: 2020-09-20
This works with POSIX and also with Windows!
Need more information? See here.

1.4. Gitlab

AsciiDoc3 can be found at

This is the up-to-date repo.

1.5. Docker

AsciiDoc3 can be found at Docker, see here

2. Release Schedule

  • consecutively: adding/completing documentation, erasing typos etc., adding/completing files at

  • AsciiDoc3-3.2.2: 2021-01-17 (dockerized See here)

  • AsciiDoc3-3.2.1: 2020-09-20 (see the comment six lines above)

  • AsciiDoc3-3.2.0: 2020-04-16

  • AsciiDoc3-3.1.0: 2019-04-19

  • AsciiDoc3-3.0.3: 2019-01-07

  • AsciiDoc3-3.0.2: 2018-06-15

  • AsciiDoc3-3.0.1: 2018-05-16

  • AsciiDoc3-3.0.1rc: 2018-04-13

You find all versions here.
Do not install outdated versions. Use them only when you know what you are doing!

3. Roadmap

Under development:

  • Dockerized Version (done! see AsciiDoc3-3.2.2)

  • AsciiDoc3 available as a module python3 -m asciidoc3 (beta)

  • GUI (beta)

  • DocBook5.1 (done! see AsciiDoc3-3.2.0)

4. Changelog


  • Python 3.6 required

  • Bugfix: Adding empty [unfloat-blockmacro] in docbook45.conf to prevent the message
    asciidoc3: WARNING: testcases_docbook45.txt: line 614: missing macro section: [unfloat-blockmacro]

  • Bugfix: Adding empty [unfloat-blockmacro] in docbook51.conf to prevent the message
    asciidoc3: WARNING: testcases_docbook45.txt: line 616: missing macro section: [unfloat-blockmacro]

  • Adding asciidoc3 to the tuple of feasible values of __name__. This is necessary since __name__ == asciidoc3 if dockerized:

  if __name__ in ('__main__', 'asciidoc3.asciidoc3', 'asciidoc3'):
      sys.stderr.write('%s: %s%s' % (self.PROG, msg, os.linesep))

3.2.1 (PyPI files only)

  • Bugfix: (Windows) When Python2 and Python3 are installed and not using venv, asciidoc3_postinstall may fail.
    GNU/Linux systems are not affected.


  • Full support of DocBook v5.1: ./doc/readme_docbook51.txt

  • Add many files regarding DocBook51: ./doc/-.- and ./tests/data/-.-

  • Updated many files in ./doc

  • Python 3.5 required

  • uses argparse instead of optparse

  • tests: ./tests/ and ./tests/

  • Improve documentation ./doc/userguide.txt =

  • Fix misspellings in various files and documents

  • use "with" for handling files instead of older try/finally pattern.

  • New file ./filters/music/example_music-filter.txt to have a pure example for the test of the standalone music converter

  • added a new path to asciidoc3 when loaded via pip/pypi

  • Removed files ./doc/asciidoc3port.txt ./doc/testsyswin.txt ./doc/asciidoc3port.txt

  • Removed files ./tests/data/deprecated-quotes.txt ./tests/data/oldtables.txt

  • Added new image: ./images/logo_asciidoc3.png

  • Added lang-se.conf lang-ja.conf lang-zh-CN.conf and correspondent files in ./tests/data

  • Renamed ./doc/READMEdoc.txt to ./doc/readme.txt

  • Added ./tests/data/nonvalid_docbook51.txt to present a valid AsciiDoc3 txt-source with non-valid Schematron DocBook51 output.

3.1.0 / 3.0.x

  • Add PyPI support (Windows / GNU/Linux)

  • Drop A-A-P based build system and change to Python3 script

Version AsciiDoc 8.6.9 (2013 — Python2)
This version was our starting point to migrate towards Python3.

5. Contact

Please do not hesitate to let me know any qestions and comments/bug reports about AsciiDoc3,
mail to info att (sorry, the contact form was switched off due to spam).