Agent Skills
返回列表
Markdown 工具箱专业版

Markdown 工具箱专业版

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @u_8ee34d77/markdown-toolkit-pro。

技能介绍

团队文档为什么容易失控

仓库里 Markdown 越积越多之后,单文件工具就不够了:目录没有统一约定、TOC 靠手改、合并前没人跑规范、内部链接断了也不知道。专业版在免费版单文件能力之上,把多文件站点、规则集 lint、死链与锚点校验、多格式导出收成一套可重复的工作流,且免费版已有规则可直接并进团队规则集。

技能如何驱动这些能力

执行侧通过 input_params、config_options、output_format 三类参数分工:前者覆盖创建、查询、导出等核心操作;config_options 负责修改、重置、导入运行时配置;output_format 管导出、保存与格式转换。站点级能力包括按主题组织目录、脚本生成 TOC;lint 侧对接 markdownlint-cli(如 MD041 首行 H1、MD024 标题不重复等),并支持豁免与 CI 阻断;链接校验可做全站扫描,内外链策略可分开;导出可走 pandoc / wkhtmltopdf 等链路出 HTML、PDF、DocBook。

推荐顺序:先把免费版规则纳入 JSON 版规则集 → 定好多文件目录(如 md-site.json)→ CI 里跑 lint 与死链 → 按归档或在线阅读选导出格式。

边界与注意点

这是 MD+EXEC 类技能:需要 Agent 能执行白名单命令且环境有 Node.js 18+;导出 PDF 时才强依赖 pandoc。不处理加密破解、损坏文件修复或物理介质恢复;复杂站点治理仍要人审目录与规则变更。无 LLM 或网络不稳时,执行质量会受影响。

使用场景

  • 产品文档从几十个独立 md 迁入统一目录后,需要自动生成 TOC 并保证每篇只有一个 H1
  • 合并请求前要在 CI 里用团队规则集跑 markdownlint,违规直接阻断合并
  • 每周对内链全站扫描,修复指向已删除章节或错误锚点的链接
  • 发布前把同一套 Markdown 批量转成 HTML 上线、PDF 留档

适合人员

  • 负责公司知识库目录规范、要把多文件 md 收成可浏览站点的技术写作负责人
  • 在开源仓库维护 CONTRIBUTING 与文档 lint 规则、希望免费版规则并入团队 JSON 规则集的维护者
  • 发版前需批量导出 HTML/PDF 并确认无死链的文档或 DevRel 工程师
  • 将文档质量门禁接入 GitHub Actions/GitLab CI 的平台或内部工具工程师