Standalone Executable

Pre-built binary packages can be downloaded from our GitHub release page. We provide them for the following platforms:

Linux: amd64 (x86-64) and arm64
macOS: arm64 (Apple Silicon) only
Windows: amd64 (x86-64)

Open an issue if your platform isn’t supported. The executables are built using the Node / JavaScript toolchain.

Install

Download the executable for your platform and make it executable with chmod or using the files properties' user interface.
Copy or clone the reveal.js presentation framework into the directory where you will build your slide deck. Here we do a shallow clone of the repo:
```
$ git clone -b 6.0.2 --depth 1 https://github.com/hakimel/reveal.js.git
```

Convert AsciiDoc into slides

Open a terminal where the executable is and type:

$ ./asciidoctor-revealjs --version

The command should report the Asciidoctor reveal.js and Asciidoctor CLI version in the terminal:

Asciidoctor reveal.js 6.0.0 using Asciidoctor.js 4.2.1 (Asciidoctor 2.0.26) [https://asciidoctor.org]
Runtime Environment (node v24.16.0 on linux)
CLI version 4.2.1

If you don’t have an existing presentation, you can create a sample presentation named presentation.adoc:

presentation.adoc

= Title Slide
:revealjsdir: reveal.js

== Slide One

* Foo
* Bar
* World

To convert the sample presentation into slides, open a terminal and type:

$ ./asciidoctor-revealjs presentation.adoc

The above command will generate a file named presentation.html. You can open this file in a browser.

Alternatively, you can use :revealjsdir: cdn.jsdelivr.net/npm/reveal.js@6.0.2 to avoid setting up reveal.js locally. Just be aware that the presentation will not load without an internet connection. Also, when using jsDelivr, speaker notes are served as plain text instead of HTML for security reasons, so they will not work.