jupyter / nbconvert

Jupyter Notebook Conversion
https://nbconvert.readthedocs.io/
BSD 3-Clause "New" or "Revised" License
1.76k stars 568 forks source link

MyST compatibility #1806

Open paugier opened 2 years ago

paugier commented 2 years ago

It would be great for presentations made with jupyter-nbconvert --to slides to be able to use MyST syntax.

Now, one can use for example

```{admonition} An admonition

blablabla...


in a markdown cell in jupyter-lab (with https://github.com/executablebooks/jupyterlab-myst), but it does not render correctly in the reveal.js presentation produced with `jupyter-nbconvert --to slides`.

Would it be possible to support MyST?

More details can be found in [this question](https://github.com/orgs/executablebooks/discussions/772).
alexandercronin commented 1 year ago

Yes would wonderful.

Use case: you have 2 audience for the same notebook

In the common tools section on the R.H.S. you could add a tag list. When a tag is selected at the top of the note book only the cells with that tag would be shown and when nbconvert was called only those features would appear in the notebook.

Wonderful product, really enjoying it!

alexandercronin commented 1 year ago

@paugier - I did a little research and I found two projects that you might like. Both which auto launch the presentation directly from a button within Jupyter Lab

  1. https://rise.readthedocs.io/en/latest/ - does not currently support MyST directives
  2. https://github.com/deathbeds/jupyterlab-deck - support MyST directives (I am experimenting with this)
franzhaas commented 10 months ago

I currently call nbconvert twice. Once to get the ipynb files from the myst files, and once to convert those to the target file format... i am happy with that...