Esc

COMARK0011 · warning

comark/broken-link

Link files that exist

A link or image whose file doesn't exist, from href and src alike, so a screenshot whose src is missing counts. A link resolves the way a site serves it: ./setup and ./setup/ find setup.md or setup/index.md. When a near name exists, the fix names it.

A relative link resolves from the document, and one that starts with / from the project root, as on GitHub. If your site serves /guide/ from another folder, map it in links.routes. The rule needs the document's path, so the command line and Vite Doctor check it, and lint() checks it when you pass file. These examples sit next to a ducks.md.

Incorrect

The north pond has [a dozen ducks](./duck.md).
md
lint-comark example.mdexample.md:1:36 comark/broken-linkThe link to ./duck.md on line 1 points at docs/doctor-include/duck.md, which doesn't exist.Did you mean ./ducks.md?✖ 1 problem

Correct

The north pond has [a dozen ducks](./ducks.md).
md
lint-comark example.md✔ No problems