What is an example of a MyST-NB example that is not a Jupyterbook #859
-
It's not very clear the difference between MyST-NB and Jupyterbook. I understand the former is the core of the latter. Unfortunately the frontpage currently points to this gallery which doesn't distinguish the two either. |
Beta Was this translation helpful? Give feedback.
Replies: 1 comment 1 reply
-
You can use MyST-NB even if you're not using jupyter book. For example, if you have .md files in your documentation that you want to execute as if they were jupyter notebooks (even if you're not writing something that is very book-like). Here is an example: I use Does that help? I kind of think of it as the |
Beta Was this translation helpful? Give feedback.
You can use MyST-NB even if you're not using jupyter book.
For example, if you have .md files in your documentation that you want to execute as if they were jupyter notebooks (even if you're not writing something that is very book-like).
Here is an example:
https://raw.githubusercontent.com/vocalpy/crowsetta/main/doc/scripts/raven-chronister-et-al-2021.md
I use
jupytext
so I can edit and execute this file as a Jupyter notebook when I'm developing, but keep it in the .md format.Then when I build I use
myst-nb
instead ofmyst_parser
Does that help?
Do you think the documentation should state that explicitly?
I'm just a user, not a dev, but just curious about what you think would help.
I ki…