Setup & Installation
openclaw skills install @wanng-ide/markdown-linter
Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:
npx clawhub install markdown-linter
What This Skill Does
Validates Markdown files in a workspace by scanning for broken local links, missing file references, and structural issues like header hierarchy and unlabeled code blocks. Outputs a structured JSON report with file locations and error details.
Catches broken internal links and structural issues in bulk across an entire workspace, rather than requiring manual inspection of each file.
When to use it
- Checking MEMORY.md for broken file references before a commit
- Validating SKILL.md links after reorganizing a project directory
- Scanning a docs folder for missing image references
- Verifying header hierarchy in a project README
- Finding unlabeled code blocks across documentation files
Example Workflow
Here's how your AI assistant might use this skill in practice.
INPUT
User asks: scan my workspace for broken links and syntax issues
AGENT
- 1Calls linter.scan('.') on the workspace root
- 2Recursively traverses all .md files
- 3Checks each [link](path) reference against the local filesystem
- 4Validates header hierarchy and code block language tags
- 5Returns a structured JSON report listing broken links and syntax errors by file and line number
OUTPUT
JSON report showing totalFiles scanned, an array of brokenLinks with file path, line number, and error message, and any syntaxErrors found