The section at https://matplotlib.org/devel/documenting_mpl.html#referring-to-mpl-documents has instructions for referencing examples but these directions appear to have been outdated by #8456. To reference the markevery demo, I had to do

:ref:`sphx_glr_gallery_pylab_examples_markevery_demo.py`