COMARK0118 · warning
comark/annotate/numbers-overlap
Leave room for each annotation's number
Each number sits on a corner of its mark, on the first corner that's clear of the other numbers. When marks crowd one spot so closely that two numbers would cover each other at every corner, readers can't tell which note goes with which mark.
Incorrect
::screenshot{src="/pond.png" alt="The pond map with three ducks"}
:::annotation{x=40 y=40 w=10 h=10}
Duck 1 on the rock.
:::
:::annotation{x=40 y=40 w=10 h=10}
Duck 2 on the rock.
:::
:::annotation{x=40 y=40 w=10 h=10}
Duck 3 on the rock.
:::
:::annotation{x=40 y=40 w=10 h=10}
Duck 4 on the rock.
:::
:::annotation{x=40 y=40 w=10 h=10}
Duck 5 on the rock.
:::
:: lint-comark example.mdexample.md:1:19 comark/annotate/numbers-overlapLeave room between the marks, or merge them into one annotation.✖ 1 problem
Correct
::screenshot{src="/pond.png" alt="The pond map with three ducks"}
:::annotation{x=40 y=40 w=10 h=10}
Five ducks share the rock.
:::
:: lint-comark example.md✔ No problems