diff --git a/docs/changelog.rst b/docs/changelog.rst
index 6336d76..9da5b46 100644
--- a/docs/changelog.rst
+++ b/docs/changelog.rst
@@ -1 +1,2 @@
-.. mdinclude:: ../CHANGELOG.md
+.. include:: ../CHANGELOG.md
+    :parser: myst_parser.sphinx_
diff --git a/docs/conf.py b/docs/conf.py
index 0d4713e..261463b 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -30,7 +30,7 @@
 # Add any Sphinx extension module names here, as strings. They can be
 # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
 # ones.
-extensions = ['m2r2']
+extensions = ['myst_parser']
 
 # Add any paths that contain templates here, relative to this directory.
 templates_path = ['_templates']
diff --git a/docs/requirements.txt b/docs/requirements.txt
index b0c773e..8aa0711 100644
--- a/docs/requirements.txt
+++ b/docs/requirements.txt
@@ -1,3 +1,3 @@
 # RTD pins by default to ancient versions
-sphinx-rtd-theme ~= 2.0
-m2r2 ~= 0.3
+sphinx-rtd-theme ~= 3.0
+myst_parser ~= 4.0