Axiom Markdown Link Auditor

Markdown link auditor — find broken internal links, flag dead external links (HEAD requests), report orphan pages. Use when you maintain docs. Pure stdlib + urllib (no LLM).

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