diff --git a/docs/conf.py b/docs/conf.py
index 22e73e5d..82098a16 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -29,7 +29,10 @@ extensions = ["myst_parser"]
 templates_path = ["_templates"]
 
 # The suffix of source filenames.
-source_suffix = [".rst", ".md"]
+source_suffix = {
+    ".rst": "restructuredtext",
+    ".md": "markdown",
+}
 
 # The encoding of source files.
 # source_encoding = 'utf-8-sig'