Backport PR #1899: Switch tutorials to myst-nb (#1904)

Co-authored-by: Philipp A <flying-sheep@web.de>

Author: meeseeksmachine

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

docs/tutorials/notebooks

@@ -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",