Skip to content
Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


Text based document generation using Python 3.x; Python3 port of AsciiDoc

AsciiDoc3 is a text document format for writing notes, documentation, articles, books, ebooks, slideshows, web pages, man pages and blogs. AsciiDoc3 files can be translated to many formats including HTML, PDF, EPUB, man page, and DocBook markup (at your choice v4.5 or v5.1). AsciiDoc3 is highly configurable: both the AsciiDoc3 source file syntax and the backend output markups (which can be almost any type of SGML/XML markup) can be customized and extended by the user.


AsciiDoc3 is written in 100% pure Python3. So you need a Python interpreter (version 3.5 or later) to execute Python is installed by default in most Linux distributions. You can download Python from the official website

Obtaining AsciiDoc3

deb rpm packages tarball generic installer zip PyPI (GNU/Linux and Windows) Pelican Plugin available! See documentation and installation instructions on the AsciiDoc3 website


Current AsciiDoc3 version tested on Debian Siduction, Ubuntu 20.04 LTS (Focal Fossa), openSUSE Tumbleweed, Windows 10, and other platforms (Python 3.7.x / 3.8.x).


AsciiDoc3 comes without dependencies (aside Python3, of course). To exploit all features of AsciiDoc3, you need - where necessary - DocBook XSL Stylesheets, xsltproc, w3m, dblatex, FOP, Pygments, graphviz ... You'll find these packages in the repos of your operating system.


Copyright © Stuart Rackham (and contributors) for AsciiDoc v8.6.9 (Python2)

Copyright © 2018-2020 Berthold Gehrke for AsciiDoc3 (Python3)

Free use of this software is granted under the terms of the GNU General Public License version 2 or later (GPLv2+).