Compatibility Matrix

reveal.js compatibility matrix

We try as much as possible to be compatible with a broad range of reveal.js versions. However, changes made by that project sometimes force us to drop compatibility with older reveal.js releases. This table tracks this compatibility, along with the reveal.js version installed as a dependency of the npm package.

Asciidoctor reveal.js version Compatible reveal.js versions reveal.js version installed by the npm package

6.x

>= 6.0

6.0.2 (6.0.0-beta.1 and 6.0.0-beta.2: 6.0.1)

5.1.x, 5.2.x

>= 4.0, < 5.0

4.5.0

5.0.x

>= 4.0, < 5.0

4.1.2

4.x

>= 3.8, < 4.0

3.9.2

3.x, 2.x, 1.x

>= 3.0, < 3.8

3.7.0 (3.x, 2.x), 3.6.0 (1.1.x), 3.3.0 (1.0.x)

Unversioned releases

2.x

-

Asciidoctor.js compatibility matrix

This section is intended only for more advanced users who combine extensions or maintain slide decks over many releases and need to update their dependencies.

Each npm package is tied to a specific major version of Asciidoctor.js, because major Asciidoctor.js releases can introduce breaking changes.

Up to the 5.x line, the converter was written in Ruby and transpiled to JavaScript with Opal, so the npm package was built for the matching Opal-based Asciidoctor.js runtime (the @asciidoctor/core package, or asciidoctor.js before 3.0). Asciidoctor.js 4.0 was rewritten in pure JavaScript, dropping Opal and the transpilation step altogether, and is published as the asciidoctor package. That rewrite is a breaking change that is not compatible with earlier releases, so the 6.x line is written in native JavaScript and requires Asciidoctor.js 4.x, which you install alongside it (it is a peer dependency).

This table tracks this compatibility.

Asciidoctor reveal.js version Compatible Asciidoctor.js versions Package and range declared in package.json

6.x

>= 4.2.1, < 5.0 (6.0.0-beta.1 and 6.0.0-beta.2: >= 4.0)

asciidoctor >=4.2.1 <5.0.0 (peer dependency; 6.0.0-beta.1 and 6.0.0-beta.2: >=4.0.0 <5.0.0)

5.1.x, 5.2.x

3.0.x

@asciidoctor/core ~3.0

5.0.x

>= 2.2.4, < 3.0

@asciidoctor/core ^2.2.4

4.1.x

>= 2.2.1, < 3.0

@asciidoctor/core ^2.2.1

4.0.x

>= 2.0.3, < 3.0 (4.0.1: >= 2.1.1)

@asciidoctor/core ^2.0.3 (4.0.1: ^2.1.1)

3.x

>= 2.0, < 3.0

@asciidoctor/core ^2.0.0 (3.1.0: ^2.0.3)

2.x

1.5.9

asciidoctor.js 1.5.9

1.1.x

1.5.6-preview.4

asciidoctor.js 1.5.6-preview.4