Bug: Linked monospace text in markdown cells does not render correctly

[eric-wieser]

Something like:

[`Cl()`](../generated/clifford.Cl.rst)

looks fine in jupyter, but in sphinx renders as

`Cl() <../generated/clifford.Cl.rst>`__.

[mgeier]

Thanks for the report!

This is a known issue, though: #301.

If you have further ideas how to tackle this, please let me know!

[eric-wieser]

Here's how you could do it - for all links, convert

some [some arbitrary rst](some_link) sentence

to

some |some_unique_id| sentence

.. |some_unique_id| replace:: some arbitrary rst
.. some_unique_id: some_link

[mgeier]

Thanks @eric-wieser, this looks promising!

Your example seems to be missing two underscores, though:

some |some_unique_id|_ sentence

.. |some_unique_id| replace:: some arbitrary rst
.. _some_unique_id: some_link

While we are still using Pandoc (see #36), I think it would make sense to add this feature directly to Pandoc's reST writer.

And lo and behold, there are already some related Pandoc issues:

• RST writer: problems with links starting/ending with code jgm/pandoc#3973
• reStructuredText outputs monospace links incorrectly jgm/pandoc#4166
• RST formatted links conversion jgm/pandoc#4339
• nested inline styles turn into extra RST text jgm/pandoc#4368
• Support RestructuredText substitution references jgm/pandoc#5995

As soon as someone implements this in Pandoc, it will be automatically available in nbsphinx.