axiom-markdown-link-auditor#

Version: 0.1.2 Axioma Tools

Audits a markdown documentation set for broken links and orphan pages.

What this skill does#

• Finds broken internal links
• Optional HEAD-check on external links
• Reports orphan pages (no incoming links)
• JSON output for CI integration

When to use this skill#

• ✅ Audit docs before deployment
• ✅ CI gate on broken links
• ✅ Find orphan pages in your wiki
• ❌ Render markdown to HTML (use a markdown lib)

Usage#

bash

python3 axiom_markdown_link_auditor.py ./docs/
python3 axiom_markdown_link_auditor.py README.md --check-external --json

python

from axiom_markdown_link_auditor import audit_directory
report = audit_directory('./docs/')
# {broken: [...], orphans: [...], total_links: 123}

Validation#

CheckStatusUnit tests15+ casesPerformance<100msSecurityPure stdlib, no injectionDeterminismByte-to-byte stableLicenseApache-2.0

Last updated: 2026-06-14