:py:class: references look weird in ipynb notebooks

[jpfeuffer]

We either need another pandoc filter to convert them to something meaningful, or try a different converter e.g. jupytext.