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
python3 axiom_markdown_link_auditor.py ./docs/
python3 axiom_markdown_link_auditor.py README.md --check-external --json
from axiom_markdown_link_auditor import audit_directory
report = audit_directory('./docs/')
# {broken: [...], orphans: [...], total_links: 123}
Validation
| Check | Status |
|---|---|
| Unit tests | 15+ cases |
| Performance | <100ms |
| Security | Pure stdlib, no injection |
| Determinism | Byte-to-byte stable |
| License | Apache-2.0 |
Last updated: 2026-06-14