diff --git a/docs/conf.py b/docs/conf.py
index bda2ad55046..0d482d48b04 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -70,7 +70,7 @@ def get_git_short_hash():
     "sphinx_tabs.tabs",
     "sphinx_copybutton",
     "nbsphinx",
-    "m2r2",
+    "myst_parser",
 ]
 
 if os.environ.get("skip_notebooks", "false") == "true":
diff --git a/docs/introduction.rst b/docs/introduction.rst
index 0b5112e6bb8..92dfcc9fa48 100644
--- a/docs/introduction.rst
+++ b/docs/introduction.rst
@@ -3,4 +3,5 @@
 Introduction
 ~~~~~~~~~~~~
 
-.. mdinclude:: ../README.md
+.. include:: ../README.md
+   :parser: myst_parser.sphinx_
diff --git a/docs/requirements.txt b/docs/requirements.txt
index e81266870b3..4b0d9f26d0f 100644
--- a/docs/requirements.txt
+++ b/docs/requirements.txt
@@ -1,12 +1,13 @@
 docutils==0.20.1
 furo==2023.9.10
 jinja2>=3.1.6
-m2r2==0.3.3.post2
+myst-parser==2.0.0
 matplotlib==3.7.3
 nbsphinx==0.9.3
 sphinx==7.1.2
 sphinx-tabs==3.4.7
 sphinx-copybutton==0.5.2
 nbconvert==7.16.6
+tinycss2>=1.1.0,<1.5
 lxml==5.2.1
 lxml_html_clean==0.4.0
diff --git a/docs/tutorial/visualization/tensorboard_plugin.rst b/docs/tutorial/visualization/tensorboard_plugin.rst
index bd0108fb48c..c192fe1a3e9 100644
--- a/docs/tutorial/visualization/tensorboard_plugin.rst
+++ b/docs/tutorial/visualization/tensorboard_plugin.rst
@@ -1,3 +1,4 @@
 .. _tensorboard_plugin:
 
-.. mdinclude:: ../../tensorboard.md
+.. include:: ../../tensorboard.md
+   :parser: myst_parser.sphinx_