Fix Broken Links

jamdesk fix is the auto-fix companion to jamdesk broken-links. It reads the same broken-link warnings and rewrites any file where the correct target can be determined unambiguously. Ambiguous cases are flagged for manual review and left untouched.

It fixes two types of broken internal links:

• Typo'd anchors — a fragment that's a clear misspelling of a real heading on the target page (e.g. #instalation → #installation)
• Cross-locale anchor drift — a translated page renamed its headings, but links in that locale still point at the old English fragment (e.g. /fr/ai/selectors#ai-strategies → /fr/ai/selectors#stratégies-ia)

Step 1: Find broken links

Run jamdesk broken-links to see what needs fixing:

jamdesk broken-links

Review the output. jamdesk fix targets warnings where a likely correct anchor can be matched to a real heading.

Step 2: Preview the fixes

Run with --dry-run to see exactly what would change before touching any files:

jamdesk fix --dry-run

Example output:

Planned fixes:

  fr/ai/overview.mdx:9
    /fr/ai/selectors#ai-strategies  →  /fr/ai/selectors#stratégies-ia

(dry run — no files written)

Check each planned fix. If a change doesn't look right, fix that link by hand instead of applying. jamdesk fix only rewrites links it can resolve unambiguously.

Step 3: Apply the fixes

Run without --dry-run to apply. You'll be prompted to confirm:

jamdesk fix

Apply 1 fix(es) to local files? (y/N)

Press y to write the changes. To skip the prompt in CI or scripts, use -y:

jamdesk fix -y

After applying, the command prints:

Fixed 1 file(s); 0 warning(s) left for manual review.

If a warning's target is ambiguous, jamdesk fix leaves it untouched for you to resolve by hand.

Step 4: Review the diff and commit

Check the changes before committing:

git diff

Verify that each rewritten link points where you expect. Then commit:

git add -A
git commit -m "fix(docs): auto-fix broken internal links"

Options

What's Next?