DOC: Add myst markdown support (#11167)

* DOC: myst config

tmp

* Add rst2myst pixi task

* Update whats-new

Author: VeckoTheGecko

doc/conf.py

@@ -54,6 +54,7 @@
     "sphinx.ext.mathjax",
     "sphinx.ext.napoleon",
     "jupyter_sphinx",
+    "myst_parser",
     "nbsphinx",
     "sphinx_autosummary_accessors",
     "sphinx.ext.linkcode",

doc/whats-new.rst

@@ -56,6 +56,8 @@ Bug Fixes
 
 Documentation
 ~~~~~~~~~~~~~
+- Add support for myst markdown (:pull:`11167`).
+  By `Nick Hodgskin <https://github.com/VeckoTheGecko>`_.
 
 
 Performance

pixi.toml

@@ -239,6 +239,7 @@ sphinx-remove-toctrees = "*"
 sphinxext-opengraph = "*"
 sphinxext-rediraffe = "*"
 cfgrib = "*"
+myst-parser = "*"
 
 [feature.doc.tasks]
 doc = { cmd = "make html", cwd = "doc", description = "Build the HTML documentation." }
@@ -331,6 +332,15 @@ depends-on = [
 ]
 description = "Check all minimum version test environments match Xarray's version policy."
 
+[feature.tools.dependencies]
+python = "3.13.*"
+
+[feature.tools.pypi-dependencies]
+rst-to-myst = { version = "*", extras = ["sphinx"] }
+
+[feature.tools.tasks]
+rst2myst = { cmd = "rst2myst", description = "Convert rst to myst markdown" }
+
 [environments]
 # Testing
 # test-just-xarray = { features = ["test"] } # https://github.com/pydata/xarray/pull/10888/files#r2511336147
@@ -443,3 +453,4 @@ default = { features = [
   "dev",
 ] }
 policy = { features = ["policy"], no-default-feature = true }
+tools = { features = ["tools"], no-default-feature = true }