首页龙虾技能列表 › Markdown Linter — Markdown 代码检查工具

Markdown Linter — Markdown 代码检查工具

v1.0.0

验证工作空间中的 Markdown 文件,检查断开的本地链接、缺失的文件引用和基本语法问题,用于维护文档完整性。

0· 722·0 当前·0 累计
by @wanng-ide (WANGJUNJIE)·MIT-0
下载技能包
License
MIT-0
最后更新
2026/4/9
安全扫描
VirusTotal
可疑
查看报告
OpenClaw
安全
high confidence
该技能的代码和指令与其声明的目的相符(扫描本地 Markdown 文件以查找断开的链接和简单的语法检查);它读取工作空间中的文件,但不执行网络访问、请求凭据或安装外部组件。
评估建议
此 Linter似乎做了它声称的所有事情:它遍历工作空间,读取 Markdown 文件,并检查链接的文件是否存在。它不传输数据,也不需要凭据。使用它在敏感工作空间之前的两个实用注意事项:(1) 如果 Markdown 文件包含指向绝对路径(以 '/' 开头)的链接,Linter 将检查这些绝对系统路径并报告是否存在 - 避免扫描可能故意探测文件系统的不可信任内容;(2) 像任何代码运行器一样,在隔离/沙盒环境中先自己审查包含的文件并运行测试。如果您需要防止绝对路径检查,请使用受控的 rootDir 运行 Linter 或修改代码以明确将前导 '/' 视为仅项目根的相对路径。...
详细分析 ▾
用途与能力
名称/描述(Markdown Linter)与包的功能一致:递归查找 .md 文件,检查本地链接目标、标题/代码块的启发式方法。包含的测试脚本在小临时目录中执行 Linter,与声明的目的一致。
指令范围
运行时指令和 index.js 保持在范围内(读取工作空间文件、验证链接)。一个值得注意的行为:以 '/' 开头的链接通过代码注释中的 path.join(rootDir, linkUrl) 处理,但由于 path.join 将绝对 linkUrl 视为绝对路径,因此如果扫描的 Markdown 中出现这样的链接,Linter 将检查绝对系统路径(例如 '/etc/passwd')。Linter 不会发送数据到外部或访问环境变量。
安装机制
没有提供安装规格(仅指令),且没有声明依赖项。这降低了风险:安装过程中除了正常使用包含的 JS 文件外, ничего不会被下载或写入。
凭证需求
该技能不请求环境变量、凭据或配置路径。代码仅使用 fs/path API,不引用 process.env 或其他秘密。
持久化与权限
该技能不请求 always:true,不修改其他技能或系统配置,并且不需要持久权限。它按需运行,可以像正常一样由代理调用。
安全有层次,运行前请审查代码。

License

MIT-0

可自由使用、修改和再分发,无需署名。

运行时依赖

无特殊依赖

版本

latestv1.0.02026/2/16

Markdown Linter 的初始发布。- 验证 Markdown 文件中的断开的本地链接和缺失的文件引用。- 检查标题层次结构的一致性。- 确保代码块在需要时使用语言标识符。- 生成有关找到的问题的详细 JSON 输出。

● 可疑

安装命令 点击复制

官方npx clawhub@latest install markdown-linter
镜像加速npx clawhub@latest install markdown-linter --registry https://cn.clawhub-mirror.com

技能文档

一个轻量级工具,用于验证工作空间中的 Markdown 文件。它专注于确保内部一致性,特别是断开的文件链接和缺失的引用。

功能

  • 链接验证:检查 link 引用的目标文件是否存在。
  • 标题检查:验证标题是否遵循逻辑层次(例如,H1 -> H2)。
  • 代码块检查:确保代码块在需要时使用语言标识符。

使用

const linter = require('./index');
const results = await linter.scan('.'); // 递归扫描当前目录
console.log(JSON.stringify(results, null, 2));

输出格式

{
  "totalFiles": 15,
  "brokenLinks": [
    {
      "file": "docs/README.md",
      "line": 10,
      "link": "./missing-image.png",
      "error": "File not found"
    }
  ],
  "syntaxErrors": []
}
数据来源:ClawHub ↗ · 中文优化:龙虾技能库
OpenClaw 技能定制 / 插件定制 / 私有工作流定制

免费技能或插件可能存在安全风险,如需更匹配、更安全的方案,建议联系付费定制

了解定制服务