diff --git a/.github/workflows/_checks.yml b/.github/workflows/_checks.yml
index b7d307d..4d6b046 100644
--- a/.github/workflows/_checks.yml
+++ b/.github/workflows/_checks.yml
@@ -31,12 +31,16 @@ jobs:
       # --offline blocks network requests and excludes every external URL, so this
       # gate is deterministic: it fails only on a relative link or file path that a
       # diff actually broke.
+      # Tag-pinned and cross-repo URLs do not match the --remap pattern and stay
+      # excluded: they point at trees this checkout does not have.
       - name: Check local links
         uses: lycheeverse/lychee-action@v2
         with:
           args: >-
             --offline
             --no-progress
+            --remap
+            'https://github\.com/${{ github.repository }}/(?:blob|tree)/main/(.*) file://${{ github.workspace }}/$1'
             '**/*.md'
 
   pytest: