diff --git a/docs/conf.py b/docs/conf.py
index 9f1699818..5a2c5a96b 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -28,7 +28,7 @@
 # default settings
 templates_path = ["_templates"]
 html_static_path = ["_static"]
-source_suffix = {".rst": "restructuredtext", ".md": "markdown"}
+source_suffix = {".rst": "restructuredtext", ".md": "myst-nb"}
 master_doc = "index"
 default_role = "literal"
 exclude_patterns = [
@@ -44,7 +44,7 @@
 pygments_style = "sphinx"
 
 extensions = [
-    "myst_parser",
+    "myst_nb",
     "sphinx_copybutton",
     "sphinx.ext.autodoc",
     "sphinx.ext.intersphinx",
@@ -60,15 +60,17 @@
     "sphinxext.opengraph",
     "scanpydoc",  # needs to be before linkcode
     "sphinx.ext.linkcode",
-    "nbsphinx",
     "IPython.sphinxext.ipython_console_highlighting",
     "sphinx_toolbox.more_autodoc.autoprotocol",
     *(p.stem for p in _extension_dir.glob("*.py")),
 ]
 myst_enable_extensions = [
     "html_image",  # So README.md can be used on github and sphinx docs
+    "colon_fence",
+    "dollarmath",
 ]
 myst_heading_anchors = 3
+nb_execution_mode = "off"
 
 # Generate the API documentation when building
 autosummary_generate = True
diff --git a/docs/tutorials/notebooks b/docs/tutorials/notebooks
index 9e186c5c6..4b9d01d85 160000
--- a/docs/tutorials/notebooks
+++ b/docs/tutorials/notebooks
@@ -1 +1 @@
-Subproject commit 9e186c5c694793bb04ea1397721d154d6e0b7069
+Subproject commit 4b9d01d857d949f40ff841f90fb03d1aaa9c9225
diff --git a/pyproject.toml b/pyproject.toml
index e0895f925..6971d3eda 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -71,7 +71,7 @@ doc = [
     "sphinx-copybutton",
     "sphinx-toolbox>=3.8.0",
     "sphinxext.opengraph",
-    "nbsphinx",
+    "myst-nb",
     "scanpydoc[theme,typehints] >=0.15.1",
     "zarr<3",
     "awkward>=2.3",