Search code examples
pythonasciidocasciidoctor

How to use AsciiDoc with Python?

The original AsciiDoc processor was written in python, but AsciiDoc evolved in the form of Asciidoctor written in Ruby.

On my search for how to process modern AsciiDoc (the Asciidoctor dialect), I only came across a post that there is an older project to port AsciiDoc to Python 3 (https://github.com/asciidoc/asciidoc/issues/83).

But since the origins of AsciiDoc are in Python, it is hard to find anything useful via google.

So what is currently the best way to process AsciiDoc from within a Python program? Call the Ruby version or commandline processor?

Solution

  • You may use Python3 to go on: you can find the brand-new Python3 port AsciiDoc3 at www.asciidoc3.org and on gitlab.com/asciidoc3/asciidoc3.

    All 170 AsciiDoc testcases are passed!