Skip to content
Switch branches/tags


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

Build Status codecov PyPI version

AsciiDoc is a text document format for writing notes, documentation, articles, books, ebooks, slideshows, web pages, man pages and blogs. AsciiDoc files can be translated to many formats including HTML, PDF, EPUB, man page. is a legacy processor for this syntax, handling an older rendition of AsciiDoc. As such, this will not properly handle the current AsciiDoc specification. It is suggested that unless you specifically require the toolchain, you should find a processor that handles the modern AsciiDoc syntax. is highly configurable: both the AsciiDoc 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.

Prerequisites is written in Python so you need a Python interpreter (version 3.5 or later) to execute asciidoc(1). You can install Python using the package manager for your OS or by downloading it from the official Python website


Documentation and installation instructions are on the website Simply, you should use use pip to install it:

pip3 install asciidoc


Copyright (C) 2002-2013 Stuart Rackham. Copyright (C) 2013-2021 Contributors.

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