Disambiguating a cross-reference

[gmacon]

I'm using the MyST plugin for Sphinx, and I have a header with an explicit target:

(introduction)=
# Introduction to a Thing with Many Words

In another file, I wrote a cross-reference to this:

[](#introduction)

This results in a warning

WARNING: more than one target found for 'myst' cross-reference inspection: could be :std:ref:`Introduction to a Thing with Many Words` or :std:doc:`Introduction to a Thing with Many Words` [myst.xref_ambiguous]

though the link is to the correct place and works as expected.

I tried to add more detail to disambiguate the link. However, changing the link to any of these:

[](ref:#introduction)
[](doc:#introduction)
[](std:ref:#introduction)
[](std:doc:#introduction)
[](ref:introduction)
[](doc:introduction)
[](std:ref:introduction)
[](std:doc:introduction)

results in

WARNING: 'myst' cross-reference target not found: 'ref:#introduction' [myst.xref_missing]

instead. Using an implicit target

[](std:ref:`Introduction to a Thing with Many Words`)

works as expected, but I'd prefer not to use implicit targets due to their fragility.

How do I properly disambiguate the link to the explicit target?