Suppress myst warnings for non-consecutive header level increases

docs/source/conf.py

@@ -37,6 +37,9 @@
 # ones.
 extensions = ["sphinx.ext.intersphinx", "docs.source.html_builder", "myst_parser"]
 
+# To prevent myst-parser from warning header level increases
+suppress_warnings = ["myst.header"]
+
 # Add any paths that contain templates here, relative to this directory.
 templates_path = ["_templates"]