Skip to content
trudy edited this page Jul 30, 2026 · 1 revision

Wiki maintenance tools

check-wiki-links.py

Validates internal wiki links — the extensionless slug links like [text](Some-Page) that GitHub resolves to Some-Page.md, plus local image/asset paths. Catches broken links and case mismatches (e.g. a link to VpnHood-Manager when the page file is VpnHood-MANAGER.md).

Off-the-shelf link checkers misread these extensionless slugs as file paths and report false positives, which is why this small script exists.

Run it

python tools/check-wiki-links.py

Prints OK and exits 0 when everything resolves; lists each problem and exits 1 otherwise (so it works in CI or a git pre-commit hook).

External URLs

This script intentionally skips http(s) links. To check those, use lychee:

lychee --include-mail '*.md'

Clone this wiki locally