Scan markdown files and verify that all hyperlinks (both local files and remote URLs) resolve correctly. Use when you need to: (1) verify documentation before publishing, (2) check a repo README or wiki links, (3) audit markdown files for broken links before generating static sites or releasing content, (4) validate links in collected digital assets before archiving.
Documents
Axiom Markdown Link Auditor
Try itMarkdown link auditor — find broken internal links, flag dead external links (HEAD requests), report orphan pages. Use when you maintain docs. Pure stdlib +...
What it does
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).
The skill document
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
Related skills
Scan web files for broken hyperlinks and weak SEO anchor text, then interactively replace, strip, or skip each dead URL. Use when asked to find or fix broken...
3 installs
Check markdown files for common issues including heading structure, link validity, list formatting, trailing whitespace, and code block language tags. Use when reviewing documentation, README files, or any .md file for consistency and best practices.
Audit a codebase or directory for deletion candidates: dead code, unused dependencies, single-use abstractions, config that never varies, and duplicated help...
1 installs
Format and lint markdown files for consistency and readability. Use when Codex needs to normalize markdown documents, fix heading levels, standardize link fo...
UUID inspector — parse any UUID and extract version (1-8), variant (RFC 4122, Microsoft, NCS, Future), timestamp (v1, v7), MAC address (v1). Use when you nee...
4 installs