Skip to main content

📚 Export with AsciiDoc

geol can generate reports in Markdown format. You can use AsciiDoc tools to convert those reports into HTML, PDF, slides, and other document formats.

⚙️ Install Asciidoctor​

Asciidoctor is a toolkit for processing AsciiDoc documents and generating professional documentation.

Install it with Homebrew:

brew install asciidoctor
info

See the official Asciidoctor documentation:

Asciidoctor Documentation

tip

Asciidoctor often produces more polished output than generic document converters, especially for HTML and PDF documents.

🔄 Convert a Markdown Report to AsciiDoc​

If you already have a Markdown report generated by geol, you can convert it to AsciiDoc format using Pandoc.

pandoc geol-report.md -f markdown -t asciidoc -o geol-report.adoc

🌐 Generate HTML Output​

Generate an HTML document from the AsciiDoc file:

asciidoctor -a toc -a toclevels=4 geol-report.adoc

📄 Generate PDF Output​

Generate a PDF document from the AsciiDoc file:

asciidoctor-pdf -a toc -a toclevels=4 geol-report.adoc
tip

You can use Asciidoctor to generate other formats and enrich your documentation with themes, tables of contents, diagrams, and advanced formatting options.