Lint & maintenance

As a wiki grows, small problems creep in: a link to a page you deleted, a page nothing points to, a mention that should be a link. Lint finds them.

What lint checks

Broken links — a page links to a target that no longer exists.
Orphan pages — a page nothing else links to (entry-point source summaries are excluded).
Missing cross-references — the text mentions another page’s title or alias but doesn’t link to it.
Frontmatter warnings — malformed or missing required frontmatter.
Stale pages — the file changed well after its updated date, so the metadata has drifted.
Missing block ids — a block that nothing can cite yet. One click stamps it, and it becomes a stable target for block references and embeds.
Dangling block references — a page.md#^id link whose page exists but no longer carries that block. The broken-link check looks at the page only; this one looks at the fragment, which is where a block deleted and re-stamped outside the app shows up.
Verbatim pages modified outside the app — a chapter or other ingested page whose file changed on disk after its updated date with no sign the editor did it. Editing in Wikai marks the page as edited from original ingest; a shell write doesn’t, so the drift is reported. Report only: Wikai keeps no copy of the ingested text to revert to.
Unresolved comment anchors — a comment whose quoted words can no longer be found in the paragraph it points at. Lint runs the same resolver the page view uses, so it and the panel’s Could not be placed list never disagree.

Run it and act

Open the Lint page for a wiki to see the latest run, grouped by check with counts by severity (error / warning / info). Each finding links to the affected page so you can fix it.

For a bigger cleanup, click Create work doc from report — Wikai turns the findings into a work document with one checklist item per issue, which the agent can then work through with you.

You can tune a couple of thresholds (how many days before a page counts as stale, the minimum length for cross-reference matches) in Settings.

Last updated 2026-10-07.