markdown-linter
by wanng-ide
Web & Frontend DevelopmentBrief
Validates Markdown files in the workspace for broken local links, missing file references, and basic syntax issues.
Description
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
User asks: scan my workspace for broken links and syntax issues
- 1
Calls linter.scan('.') on the workspace root
- 2
Recursively traverses all .md files
- 3
Checks each [link](path) reference against the local filesystem
- 4
Validates header hierarchy and code block language tags
- 5
Returns a structured JSON report listing broken links and syntax errors by file and line number
JSON report showing totalFiles scanned, an array of brokenLinks with file path, line number, and error message, and any syntaxErrors found
Installation
clawhub install wanng-ide/markdown-linterRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.