How to convert ASCIIDoc file to PDF

ASCIIDoc is a good format to create documents, articles and books. While it is designed for conversion to HTML webpages, it can also be converted to a PDF file. This is especially useful for articles and books. This conversion can be done using a converter called ASCIIDoctor PDF.

To install and use ASCIIDoctor PDF:

• Install Ruby and gem, if you have not already.

• Install ASCIIDoctor PDF:

$ sudo gem install asciidoctor-pdf --pre

• Check if converter is working:

$ asciidoctor-pdf -v

• Convert an ASCIIDoc file to PDF of the same name:

$ asciidoctor-pdf foobar.adoc

This generates a foobar.pdf file.

Tried with: ASCIIDoctor PDF 1.5.0.beta.1, Asciidoctor 2.0.10, Ruby 2.5.1p57, Ubuntu 18.04