（4623期）Markdown Linter – 文档链接完整性守护者

文档链接完整性守护者 轻量级 Markdown 文档验证工具，可检测断链、缺失文件引用及基础语法问题，保障文档完整性。 使用说明 核心用法 markdown-linter 是一款专注于本地 Markdown 文件质量保障的轻量级验证工具，主要面向开发者文档维护场景。其核心功能围绕三类检查展开： 链接有效性验证：扫描 [text](path) 格式的内部链接，确认引用的本地文件真实存在，有效避免 MEMORY.md、SKILL.md 等配置文档中出现失效引用。 标题层级检查：验证 Markdown 标题从 H1 到 H6 的层级递进逻辑，防止出现跳跃式标题结构（如 H1 后直接接 H3），提升文档可读性。 代码块规范检查：识别未标注编程语言的代码围栏（```），提示补充语言标识符以优化渲染效果。 使用方式简洁，通过 Node.js 模块调用：const linter = require('./index'); await linter.scan('.')，支持递归扫描目录并返回结构化 JSON 报告。 显著优点 专注本地场景：不依赖外部网络，纯离线检测，响应速度快，适合 CI/CD 流水线集成 精确错误定位：输出包含文件路径、行号、具体问题描述，便于快速修复 轻量零依赖：实现简单，易于嵌入各类文档项目 结构化输出：JSON 格式便于程序化处理和自动化报告生成 潜在局限 功能范围较窄，不涉及 Markdown 渲染兼容性、HTML 嵌入安全、外部 URL 可达性等深度检查 代码块语言检测仅为建议性质，无法验证标识符准确性 缺乏配置化能力（忽略规则、自定义路径映射等） 当前实现基于 Node.js require，对 ESM 项目可能需要适配 适合人群 维护多文档仓库的技术写作者 需要保障内部链接完整性的开源项目维护者 构建文档质量门禁的 DevOps 工程师 常规风险 风险等级较低。工具仅执行本地文件系统读取操作，不执行任意代码、不发起网络请求。需注意扫描路径权限控制，避免无意暴露敏感文件路径信息到输出报告中。 原始说明 Validates Markdown files in the workspace for broken local links, missing file references, and basic syntax issues. Use to maintain documentation integrity a...