上一篇
(3791期)ESLint Config Generator – 一键生成专业 ESLint 配置
下一篇
(3789期)Watch & Learn – 占位模板生成·未含真实扫描
Markdown 标准化与 pre-commit 守护者 为仓库一键配置 markdownlint 格式检查与 pre-commit 钩子,支持批量修复 MD013/MD040 等常见违规,适配中英文混合场景与 monorepo 结构。 使用说明 核心用法 markdown-lint skill 是一套面向工程团队的 Markdown 标准化解决方案,核心解决三个场景:新仓库初始化时建立格式基线、存量文件的批量检查与修复、以及跨仓库的标准迁移。它围绕 markdownlint-cli2 构建,并配套自定义 pre-commit 钩子禁止水平线(---)滥用,形成「工具配置 + 代码提交拦截」的双重保障。 显著优点 开箱即用的 CJK 优化:默认关闭 MD013(行长度)、MD060(表格管道符间距)等对中文内容极不友好的规则,避免误报。 水平线专项管控:通过独立脚本 check-horizontal-rules.sh 禁止正文中的 ---,但保留 YAML frontmatter,解决文档视觉风格碎片化问题。 monorepo 友好:支持 #repos、#node_modules 排除语法,避免对子仓库或依赖目录重复 lint。 自动化修复优先:--fix 参数可自动处理大部分格式问题,显著降低人工介入成本。 潜在缺点与局限性 依赖 Node.js 生态:需安装 Node 或借助 npx,在纯 Python 或 Rust 仓库中增加环境复杂度。 Windows 兼容性短板:Bash 脚本依赖 Git Bash/WSL,纯 Windows CMD/PowerShell 环境体验受限。 规则豁免需人工判断:MD025、MD045 等规则是否禁用,需根据「自研文档 vs 导入 vendor 文档」人工决策,无法全自动。 部分规则不可自动修复:MD040(代码块无语言标识)等需手动添加 `text 等标签。 适合人群 技术文档工程师、开发者体验(DX)团队,需要为多语言仓库建立统一的 Markdown 提交规范。 开源项目维护者,希望在 CI 前通过 pre-commit 拦截格式问题,减少 review 噪音。 常规风险 配置漂移:.markdownlint.json 若分散在多个仓库,版本同步需依赖人工或模板仓库机制。 frontmatter 误删:批量移除水平线的 awk 脚本若遇到非标准 frontmatter 格式(如首行非 ---),可能误删内容,建议先备份或 dry-run。 hook 版本滞后:pre-commit autoupdate 若被遗漏,可能长期锁定旧版 markdownlint,错失新规则或性能改进。 原始说明 Use this skill immediately when the user needs to: set up markdownlint-cli2 and pre-commit hooks in a repository, fix or batch-repair markdownlint errors lik...
Markdown 标准化与 pre-commit 守护者
为仓库一键配置 markdownlint 格式检查与 pre-commit 钩子,支持批量修复 MD013/MD040 等常见违规,适配中英文混合场景与 monorepo 结构。
markdown-lint skill 是一套面向工程团队的 Markdown 标准化解决方案,核心解决三个场景:新仓库初始化时建立格式基线、存量文件的批量检查与修复、以及跨仓库的标准迁移。它围绕 markdownlint-cli2 构建,并配套自定义 pre-commit 钩子禁止水平线(---)滥用,形成「工具配置 + 代码提交拦截」的双重保障。
显著优点
check-horizontal-rules.sh 禁止正文中的 ---,但保留 YAML frontmatter,解决文档视觉风格碎片化问题。#repos、#node_modules 排除语法,避免对子仓库或依赖目录重复 lint。--fix 参数可自动处理大部分格式问题,显著降低人工介入成本。潜在缺点与局限性
npx,在纯 Python 或 Rust 仓库中增加环境复杂度。 `text 等标签。适合人群
常规风险
.markdownlint.json 若分散在多个仓库,版本同步需依赖人工或模板仓库机制。---),可能误删内容,建议先备份或 dry-run。pre-commit autoupdate 若被遗漏,可能长期锁定旧版 markdownlint,错失新规则或性能改进。Use this skill immediately when the user needs to: set up markdownlint-cli2 and pre-commit hooks in a repository, fix or batch-repair markdownlint errors lik…
本站提供的资源转载自国内外各大媒体和网络,仅供试玩体验;不得将上述内容用于商业或者非法用途,否则,一切后果请用户自负。您必须在下载后的24个小时之内,从您的电脑中彻底删除上述内容。如果您喜欢该游戏内容,请支持正版,购买注册,得到更好的正版服务。我们非常重视版权问题,如有侵权请邮件与我们联系处理。
上一篇
(3791期)ESLint Config Generator – 一键生成专业 ESLint 配置
下一篇
(3789期)Watch & Learn – 占位模板生成·未含真实扫描
还没有玩家留言,来抢沙发吧~
登录后即可发表你的资源评测、评分,与其他玩家交流