@markers

Where marker comments may sit, and paired open/close dispositions.

Mission control: These systems are still on the test stand. Fly them, log everything.

Under review: works today, may fold into expressions or a vocabulary before 1.0.

Quick reference

Examples

@markers/placement.guarded

Warn when the nearest preceding marker (a mask/lexicon match) sits more than proximity= blocks before the target link — present, but not close enough to read as placed there.

<!-- mdv: document @markers/placement.guarded=pivot="amzn.to","/go/";marker="affiliate","commission";proximity=2 -->

@markers/placement.weakGuarded

Warn when the only marker preceding the target is a link whose LABEL matches, not text stated directly in the block's own prose.

<!-- mdv: document @markers/placement.weakGuarded=pivot="amzn.to","/go/";marker="affiliate","commission" -->

@markers/placement.unguarded

Warn when every marker (if any) sits at or after the target — nothing guards it beforehand. anchor=firstAfter (default) or anchor=pivot picks the reported line.

<!-- mdv: document @markers/placement.unguarded=pivot="amzn.to","/go/";marker="affiliate","commission" -->

@markers/placement.unguardedRegion

Warn when an inline marker sits inside the trailing regionFraction= of the document, after the target — buried, not merely late.

<!-- mdv: document @markers/placement.unguardedRegion=pivot="amzn.to","/go/";marker="affiliate","commission";regionFraction=0.75 -->

@markers/placement.absent

Warn when a target exists but no marker (mask/lexicon match) exists anywhere in the document.

<!-- mdv: document @markers/placement.absent=pivot="amzn.to","/go/";marker="affiliate","commission" -->

@markers/disposition.open

FIFO declare/resolve pairing within heading-bounded sections: every open-mask line must be closed by a close-mask line in the same section, oldest first; leftovers report.

<!-- mdv: fragment anomaly-detail=".*" -->
<!-- mdv: fragment resolution-detail=".*" -->
<!-- mdv: document @markers/disposition.open="Anomaly: <anomaly-detail>" @markers/disposition.close="Resolution:<resolution-detail>" -->

@markers/disposition.close

A close mask for @markers/disposition.open, or an array of them — a line matching one closes the oldest open entry in the section.

On this page