Doctor

comark-linter reports each problem under a rule, and Vite Doctor reports it under that rule's code.

The core rules catch what Comark forgives: blocks never closed, misspelled components, broken anchors, and unsafe URLs. Each package adds one rule for each kind of problem its plugin puts in meta.issues. That way you can tell them apart in a report and look each one up here.

docs/review.md:8:1 comark/annotate/box-outside-image screenshot "after.png", annotation 2: the box runs past the image edge. Keep x + w and y + h within 100.

pnpm lint-comark "docs/**/*.md"

Or add comark-linter/doctor to doctor.config.ts, and the comark/recommended preset turns every rule on. Vite Doctor has the setup.

Each plugin adds its sentences to meta.issues, as it always has, and also names the rule of each one in meta.issueRules, keyed by the sentence:

const { meta } = await parseMarkdown(markdown, { plugins: [embed()] });
meta.issues; // ["`::embed` 1: `url` must start with https://."]
meta.issueRules; // { "`::embed` 1: `url` must start with https://.": "comark/embed/insecure-url" }

An issue no rule names, such as one from a plugin of your own, is reported as comark/plugin-issue.