diff --git a/.github/workflows/asciidoctor-ghpages.yml b/.github/workflows/asciidoctor-ghpages.yml
index 1182a6c..fb56ff6 100644
--- a/.github/workflows/asciidoctor-ghpages.yml
+++ b/.github/workflows/asciidoctor-ghpages.yml
@@ -40,7 +40,8 @@ jobs:
           node-version: 20
       - name: Install Mermaid
         run: |
-          sudo npm install -g @mermaid-js/mermaid-cli@11.2.0
+          sudo npm install -g @mermaid-js/mermaid-cli@11.2.1
+          npx puppeteer browsers install chrome-headless-shell
       - name: Install asciidoctor
         run: |
           sudo apt update
diff --git a/.gitignore b/.gitignore
index 150fbd2..5aa95cd 100644
--- a/.gitignore
+++ b/.gitignore
@@ -15,3 +15,4 @@ __pycache__
 .pytest_cache
 .hypothesis
 requirements.txt
+docs/puppeteer_config.json
diff --git a/docs/index.adoc b/docs/index.adoc
index b2689fe..7cc8cad 100644
--- a/docs/index.adoc
+++ b/docs/index.adoc
@@ -5,6 +5,7 @@
 :rouge-style: base16.solarized
 :source-language: c++
 :toc: left
+:mermaid-puppeteer-config: puppeteer_config.json
 
 include::intro.adoc[]
 include::atomic.adoc[]