diff --git a/docs/conf.py b/docs/conf.py
index d130cc760..091f0cc9e 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -240,3 +240,6 @@ html_show_sphinx = False
 
 # Output file base name for HTML help builder.
 #htmlhelp_basename = ''
+
+# https://myst-parser.readthedocs.io/en/latest/syntax/cross-referencing.html#handling-invalid-references
+suppress_warnings = ["myst.xref_missing"]