Skip to content


Folders and files

Last commit message
Last commit date

Latest commit


Repository files navigation

--> Repo has moved to <--

Do not fork this repo any more: outdated, insecure ...


Text based document generation using Python3; 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.7 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) Docker Pelican Plugin available! See documentation and installation instructions on the AsciiDoc3 website


Current AsciiDoc3 version tested on Debian Siduction, Ubuntu 22.04 LTS (Jammy Jellyfish), openSUSE Tumbleweed, Ghost BSD, Windows 10/11, ...


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-2018 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+).