diff --git a/docs/conf.py b/docs/conf.py
index 6d20ecf4b9..6ef7d0daf9 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -278,7 +278,7 @@
 myst_enable_extensions = ["colon_fence"]
 
 # Sphinx-mermaid config
-mermaid_output_format = "raw"
+mermaid_output_format = "png"
 mermaid_version = "latest"
 mermaid_init_js = "mermaid.initialize({startOnLoad:false});"