Support nested inline markup properly

[rgaiacs]

Describe the feature you'd like to request

I like to be able to use code block inside links in the final HTML, for example

<p><a href="https://github.com/jupyterhub/repo2docker"><code>repo2docker</code></a></p>

The above HTML can be created from the following Markdown

[`repo2docker`](https://github.com/jupyterhub/repo2docker)

that is compliant with original Markdown and CommonMark.

Unfortunately, MyST live preview converts the the above Markdown into

<p><a class="reference external" href="https://github.com/jupyterhub/repo2docker"><span class="docutils literal">repo2docker</span></a></p>

docutils's FAQ includes

2.16 Is nested inline markup possible?

Not currently, no. It's on the to-do list (details here), and hopefully will be part of the reStructuredText parser soon.

This is a feature request that goes all the way back to 2001.

Describe the solution you'd like

[`repo2docker`](https://github.com/jupyterhub/repo2docker)

to produce

<p><a href="https://github.com/jupyterhub/repo2docker"><code>repo2docker</code></a></p>

Describe alternatives you've considered

docutils's FAQ recommends to use "raw" directive, i.e. use HTML directly. This is undesired as the feature is part of CommonMark.

[chrisjsewell]

myst-parser correctly creates the correct syntax tree for the inline markup, as shown in the live-preview:

<document source="<string>">
    <paragraph>
        <reference refuri="https://github.com/jupyterhub/repo2docker">
            <literal>
                repo2docker

conversion of the AST to HTML is not handled by myst-parser, you would need to take it up with sphinx / docutils:

• sphinx already does this: https://github.com/sphinx-doc/sphinx/blob/aeeaeafc8a1198dc1b982d28bd23495a987aeb5d/sphinx/writers/html5.py#L661
• docutils acts differently: https://github.com/live-clones/docutils/blob/556bbba43b4529f0b53c852be39ce9e262b633ed/docutils/docutils/writers/html5_polyglot/__init__.py#L290