用途:md-validation 用于在发布前校验 Markdown 文档中的链接与 Mermaid 图表,避免多页产物或知识库出现失效的交叉引用和渲染错误。
主要能力:一是 Mermaid 图表校验,要求在浏览器中打开 HTML 产物并逐张目视检查,因为语法错误通常表现为渲染破损而非报错信息;二是 Markdown 链接校验,检查页面之间的相对链接能否正确解析,确认每个链接目标在提交前确实存在。
常见 Mermaid 失败模式:带标点且未加引号的标签会破坏解析;裸写的小写 end 会与 subgraph 终止符冲突;边标记之后以 o 或 x 开头的节点 ID 会被错误解析;自定义填充色与文字颜色不匹配会导致标签不可读。完整编写规则(引号、换行、保留字、主题)见 resources/mermaid-authoring.md。
使用方式与限制:资料未提供具体安装命令、调用参数或自动化脚本,仅说明需在浏览器中人工目视检查图表,并在提交前逐一验证链接目标。