nbconvert icon indicating copy to clipboard operation
nbconvert copied to clipboard

MyST compatibility

Open paugier opened this issue 2 years ago • 3 comments

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.

paugier avatar Jul 06 '22 04:07 paugier

Yes would wonderful.

Use case: you have 2 audience for the same notebook

  • Audience 1: only show sections of the note book as a presentation
  • Audience 2: full notebook - they wish to participate in a lectorial (lecture + tutorial) with interactive exercises.

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 avatar Sep 22 '23 21:09 alexandercronin

@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)

alexandercronin avatar Sep 22 '23 22:09 alexandercronin

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...

franzhaas avatar Feb 05 '24 17:02 franzhaas