myst.xref_missing - How to disabe ref checks for SMILES strings?

[Scienfitz]

Hi,

I have a bunch if python files (examples of a python package) that are converted to .md files and then combined into our documentation. This works great, but in one of the files I have the following line as part of a dictionary:

    "SCHEMBL15068049": r"C[C@]1(O2)O[C@](C[C@]2(C)P3C4=CC=CC=C4)(C)O[C@]3(C)C1",

The value of this entry is a SMILES, i.e. a string representing a molecule. Symbols like @ have chemical meaning and cannot be changed. It appears this [...](...) pattern is falsely recognized as a link, resulting in this error:

Warning, treated as error:
/home/runner/work/baybe/baybe/docs/examples/Backtesting/full_lookup.md:229:'myst' cross-reference target not found: 'C[C@]2(C)P3C4=CC=CC=C4' [myst.xref_missing]

Does anyone have suggestions on how to fix this? I dont want to turn of linkchecks globally, ideally just for that line. I also cannot change the string in question too strongly as it still needs to be parsable by the cheminformatics tool treating it as a molecule.

• myst-parser==3.0.1
• sphinx==7.4.7
• sphinx-autodoc-typehints==2.2.3
• sphinx-basic-ng==1.0.0b2
• sphinx-copybutton==0.5.2
• sphinxcontrib-applehelp==1.0.8
• sphinxcontrib-bibtex==2.6.2
• sphinxcontrib-devhelp==1.0.6
• sphinxcontrib-htmlhelp==2.0.6