diff --git a/docs/conf.py b/docs/conf.py
index 60a92e37d..874f33b6b 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -39,6 +39,7 @@
     "sphinx.ext.napoleon",
     "sphinx.ext.extlinks",
     "numpydoc",
+    "myst_parser",
 ]
 
 ## Generate autodoc stubs with summaries from code
diff --git a/docs/index.md b/docs/index.md
new file mode 100644
index 000000000..5115a948f
--- /dev/null
+++ b/docs/index.md
@@ -0,0 +1,3 @@
+```{eval-rst}
+.. include:: ../README.rst
+```
diff --git a/docs/index.rst b/docs/index.rst
deleted file mode 100644
index 6b2b3ec68..000000000
--- a/docs/index.rst
+++ /dev/null
@@ -1 +0,0 @@
-.. include:: ../README.rst
\ No newline at end of file