Have you considered Asciidoc format ?

[bhugueney]

Thank you for this very useful software !
I'm currently looking for text formats and tools to generate interactive teaching materials, including slides. For client-side interaction, I'm using Klipse and when server-side execution is required, I'm using Notebooks.
For now, I'm using emacs org-mode format, converted to reveal.js + klipse with emacs-reveal or converted to Notebooks (including with reveal.js display) with ox-ipynb.
However, for users who do not use emacs, I was thinking about Asciidoc which I can convert to reveal.js + Klipse with asciidoctor-revealjs-klipse.
I would need to be able to convert it to Notebook format, and I wondered if jupytext could be of any help with that as the description of Asciidoc states :

AsciiDoc belongs to the family of lightweight markup languages, the most renowned of which is Markdown.

What do you think ?

Best Regards.

[mwouts]

Hello @bhugueney, thank you for describing your workflow!

Regarding org-mode, we did discuss in the past the possibility of implementing an org-mode representation for notebooks (#62), but that turned to be not easy as Markdown because the text found in notebooks is written in Markdown, not org-mode.

I think if we try implementing support for Asciidoc we would face the same problem. Should the Asciidoc text be converted to Markdown when the document is converted to an ipynb notebook? Should the Markdown in the notebook be converted back to Asciidoc?

So, I think the safest recommendation I can provide here is... why not using Markdown? Is there anything you can do with Asciidoc that you cannot with Markdown?

Also, I have seen a few people using Jupytext+RISE (i.e. build revealjs slides from Markdown), this has been supported since version 1.1.0 (#66).

[bhugueney]

Thank you for bringing to my attention that RISE is supported, I will probably tell my non-emacs users to use Markdown.
I'll open an other issue wrt supported programming languages.

Best Regards.