A single example of using MyST markdown features to setup intersphinx for the notebooks site.
The main advantage is that we can use roles+directives+sphinx extensions for the notebooks!
The main disadvantage is that the extended (i.e. non-commonmark) MyST features are not yet supported in Jupyter notebooks. So for users who are using binder and/or running notebooks locally w/ jupyter notebook, the markup will not render properly.
I'm going to close this since for now since a decision has been made in #32 - we can revisit this idea (and similar) if/when these features are supported in the notebook environment.
A single example of using MyST markdown features to setup intersphinx for the notebooks site.
The main advantage is that we can use roles+directives+sphinx extensions for the notebooks!
The main disadvantage is that the extended (i.e. non-commonmark) MyST features are not yet supported in Jupyter notebooks. So for users who are using binder and/or running notebooks locally w/
jupyter notebook
, the markup will not render properly.