mkdocs-revealjs

Embed one or more Reveal.js presentations directly inside MkDocs Markdown pages, with light/dark theme synchronization and native integration with other MkDocs plugins.

Documentation & live demos: https://rod2ik.gitlab.io/mkdocs-revealjs/

Modes

A page-wide presentation uses the canonical mode:

---
revealjs:
  mode: diapo
---

A Reveal.js evaluation powered by mkdocs-superquiz uses:

---
revealjs:
  mode: diapo.eval
---

There is intentionally no legacy presentation: syntax in 0.10.0.

Accepted mode aliases

Canonical	Accepted aliases
`diapo`	`diaporama`, `presentation`, `diapo.presentation`, `diapo.normal`
`diapo.eval`	`eval`, `evaluation`, `exam`, `examen`, `assessment`, `diapo.evaluation`, `diapo.exam`, `diapo.examen`, `diapo.assessment`

Documentation uses only the canonical forms after this table.

Multiple decks in one Markdown page

Use explicit deck blocks. Five or more = are accepted; the canonical form is:

Ordinary MkDocs content.

=====

# Slide 1

---

# Slide 2

=====/

Ordinary MkDocs content again.

Each block may start with local front matter:

=====

---
mode: diapo.eval
id: algebra-test
revealjs:
  transition: fade
superquiz:
  randomize: all
---

...slides...

=====/

id is optional. Missing identifiers are generated as diapo1, diapo2, eval1, eval2, ...

Optional Markdown imports with mkdocs-macros-plugin

Install the optional extra and enable macros before superquiz/revealjs:

pip install "mkdocs-revealjs[macros]"

plugins:
  - macros
  - superquiz
  - revealjs

Then import all explicit decks from another Markdown file at the exact insertion point:

{{ diapo("slides/demo.md") }}

Alias:

{{ include_diapo("slides/demo.md") }}

Select one explicitly named deck with a fragment:

{{ diapo("slides/demo.md#algebra-test") }}

Relative paths are resolved from the current Markdown source file. A leading / means the MkDocs docs_dir root, never the operating-system root. Imports may not escape docs_dir.

Configuration scopes

Reveal.js values resolve from least to most local:

built-in defaults < mkdocs.yml < page front matter < deck-local front matter

SuperQuiz adds its own per-type and per-question layers. An explicit deck is a scope: a diapo.eval deck owns its own evaluation session; an explicit normal diapo deck keeps its questions embedded even inside a page-level SuperQuiz evaluation.

Highlights

multiple independent Reveal.js decks per page;
horizontal and vertical slides;
Material light/dark synchronization, including Android Reveal Scroll View backgrounds;
Reveal.js, Highlight.js and Mermaid light/dark theming;
server-side compatibility islands for MkDocs extensions;
native mkdocs-superquiz, mkdocs-maths-admonitions, XTables and TikZJax integration;
fragments, notes, auto-animate and Reveal.js options;
optional diapo() / include_diapo() macros;
diapo.eval sessions with global SuperQuiz validation, scoring, timer, question navigation, and a dedicated post-validation result/violation-summary slide.
mkdocs-superquiz >= 0.5.8 evaluation integration: the first click anywhere inside the visible diapo.eval wrapper enters deck-scoped fullscreen before password entry for both standard and strict evaluations. QR/timer/Reset/Unlock/live counts share one draggable deck toolbar, while numbered question navigation remains independently draggable. Strict defaults show QR + Reset and hide Unlock; the timer defaults to a 50-minute countdown; every recorded strict violation emits a stacked transient tooltip above the deck UI.

Development

yarn dev
yarn dev:lan
yarn build
yarn build:full
yarn bfc

yarn dev:lan binds MkDocs to 0.0.0.0:8000 for testing from a real phone on the same LAN.

License

GNU GPL-3.0-or-later.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mkdocs_revealjs-0.11.0.tar.gz (66.7 kB view details)

Uploaded Aug 14, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

mkdocs_revealjs-0.11.0-py3-none-any.whl (55.4 kB view details)

Uploaded Aug 14, 2026 Python 3

File details

Details for the file mkdocs_revealjs-0.11.0.tar.gz.

File metadata

Download URL: mkdocs_revealjs-0.11.0.tar.gz
Upload date: Aug 14, 2026
Size: 66.7 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.14.7

File hashes

Hashes for mkdocs_revealjs-0.11.0.tar.gz
Algorithm	Hash digest
SHA256	`9117aca556d265698784db2f87879fb5cce84a6550c98bcd508666333d4e43fd`
MD5	`6255f6b8f11906dedec2f84563bcd90a`
BLAKE2b-256	`67d7e2adbf3575379579a10af6858f7ac08302f81f4ebe7c35dee328e01f9b26`

See more details on using hashes here.

File details

Details for the file mkdocs_revealjs-0.11.0-py3-none-any.whl.

File metadata

Download URL: mkdocs_revealjs-0.11.0-py3-none-any.whl
Upload date: Aug 14, 2026
Size: 55.4 kB
Tags: Python 3
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.14.7

File hashes

Hashes for mkdocs_revealjs-0.11.0-py3-none-any.whl
Algorithm	Hash digest
SHA256	`52e41d402f4441787fd9d6c48a277b38dc2aad501088fa3f6380324561dd4401`
MD5	`b567c7512a728bc5e76839b0078ef54d`
BLAKE2b-256	`3b2410e8bf786b31d676b4f684ec66ab130c31d470f580b860b9a0eebf60cbe7`