This PR switches our approach to rendering notebooks from one that embeds raw HTML rendered using nbconvert to an approach that converts the notebooks to real docutils nodes ensuring that links, anchors, sections and other cross-referencing is properly supported. This support is built on top of jupyter_sphinx via the myst_nb extension. As a side-effect this also means that:
Parsing of .md files is now enabled by default
Parsing of .ipynb files is now enabled by default (i.e. they do not have to be wrapped by the notebook directive)
This PR switches our approach to rendering notebooks from one that embeds raw HTML rendered using nbconvert to an approach that converts the notebooks to real docutils nodes ensuring that links, anchors, sections and other cross-referencing is properly supported. This support is built on top of
jupyter_sphinxvia themyst_nbextension. As a side-effect this also means that:.mdfiles is now enabled by default.ipynbfiles is now enabled by default (i.e. they do not have to be wrapped by thenotebookdirective)