Esc

COMARK0116 · warning

comark/annotate/nested-block

Keep screenshots, compares, and annotations out of notes and captions

Screenshots, compares, and annotations are read only where they belong: an annotation as a direct child of a screenshot, and a screenshot or compare outside other notes and captions. One inside a note or a caption isn't read as part of the screenshot, so its mark isn't drawn.

Incorrect

::screenshot{src="/pond.png" alt="The pond map with three ducks"}
:::annotation{x=20 y=30 w=15 h=10}
The duck without a name tag.

::::annotation{x=50 y=30 w=15 h=10}
The duck with two.
::::
:::
::
md
lint-comark example.mdexample.md:1:19 comark/annotate/nested-blockscreenshot "/pond.png", annotation 1: annotation can't go inside a note or caption.Annotations must be direct children of a screenshot.✖ 1 problem

Correct

::screenshot{src="/pond.png" alt="The pond map with three ducks"}
:::annotation{x=20 y=30 w=15 h=10}
The duck without a name tag.
:::
:::annotation{x=50 y=30 w=15 h=10}
The duck with two.
:::
::
md
lint-comark example.md✔ No problems