diff --git a/docs/conf.py b/docs/conf.py
index 674716a49..3368bb727 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -22,7 +22,7 @@
 from distutils.version import LooseVersion
 
 import sphinx
-from m2r import MdInclude
+from m2r2 import MdInclude
 from sphinx_gallery.sorting import FileNameSortKey
 
 sys.path.insert(0, os.path.abspath(os.path.pardir))
diff --git a/setup.cfg b/setup.cfg
index 351bd4e80..0eb3197f1 100644
--- a/setup.cfg
+++ b/setup.cfg
@@ -70,9 +70,9 @@ gzip =
 cbmr = 
     torch>=2.0 # for cbmr models
 doc =
-    m2r
+    m2r2
     matplotlib
-    mistune<2  # just temporary until m2r addresses this issue
+    mistune
     pillow
     recommonmark
     seaborn