comark/xref/ref-content · Keep text out of :ref

A :ref always reads as its label's number, such as "Figure 2", so the text written in its brackets is dropped. Write the words around the reference instead.

Incorrect

![The pond after the cleanup](pond.png){#fig-pond}

Compare it with :ref[the clean pond]{#fig-pond}.

lint-comark example.mdexample.md:3:22 comark/xref/ref-content:ref 1 drops its text "the clean pond", since a reference reads as its label's number.Remove the brackets: :ref{#fig-pond}.✖ 1 problem

Correct

![The pond after the cleanup](pond.png){#fig-pond}

Compare it with the clean pond in :ref{#fig-pond}.

lint-comark example.md✔ No problems