核心用法
Markdown-Formatter 是一款专注于 Markdown 文档格式化与美化的一站式工具，提供 formatMarkdown（单文档格式化）、formatBatch（批量处理）、lintMarkdown（语法检查）三大核心功能。用户可通过配置风格指南（CommonMark、GitHub Flavored Markdown 或自定义规则）及 20+ 细粒度选项，实现从简单清理到复杂重构的全流程文档优化。
显著优点
- 多风格适配：原生支持 CommonMark、GitHub 风格及自定义规则，满足开源项目、技术博客、API 文档等多元场景
- 结构无损处理：承诺 100% 保留原始文档结构，特别适合处理嵌套列表、代码块、表格等复杂元素
- 智能批量能力：支持多文件并发处理，配备完整统计与错误隔离机制，适合 CI/CD 流水线集成
- 开发者友好：提供详细的 lint 报告、行级错误定位及自动修复建议，显著降低手动维护成本
潜在局限
- 性能瓶颈：超大型文档（5000+ 词）处理耗时可达 200-500ms，极端规模下可能成为流水线瓶颈
- 风格覆盖盲区：官方宣称 95%+ 风格合规率，意味着仍存在边缘 case 需人工干预
- 依赖外部生态：作为 ClawHub 平台技能，实际可用性与平台稳定性强绑定，跨平台迁移成本不明
适合人群
开源维护者、技术文档工程师、DevOps 从业者、内容创作者（尤其是使用 GitHub/GitLab 工作流者）。
常规风险
- 过度格式化风险： aggressive 的列表修复或间距规范化可能意外改变作者本意排版
- 批量操作不可逆：若无版本控制配合，批量处理大量文件可能引入难以追溯的格式变更
- 自定义规则复杂度：regex-based 自定义规则缺乏沙箱机制，不当配置可能导致解析异常或性能骤降