[wiz21c]

I'll look at it.

My major gripe with jupyter is that it's hard to document classes because a class must be inside one code block and you can't mix in comments block...

(unless I didn't see some obvious thing)

[pizza]

Could you have special markdown cells that have mixed python code blocks and other inline media that gets converted to stripped python cells? You might be able to write an ipython ‘magic’ for something like that