用途:把纯文本或 Markdown 文件整理为结构规范的 Markdown,补齐 frontmatter、标题、摘要、标题层级、加粗、列表与代码块,并处理中日韩(CJK)排版问题。
主要能力:脚本位于 scripts/ 子目录,需把 ${SKILL_DIR} 替换为 SKILL.md 所在目录。scripts/main.ts 是带 CLI 选项的主入口(使用 remark-cjk-friendly 处理 CJK 强调);scripts/quotes.ts 将 ASCII 引号替换为全角引号;scripts/autocorrect.ts 通过 autocorrect 添加 CJK 与英文之间的空格。支持通过 EXTEND.md 自定义默认格式化选项和摘要长度偏好,优先读取项目级 .baoyu-skills/baoyu-format-markdown/EXTEND.md,其次用户级 $HOME/.baoyu-skills/baoyu-format-markdown/EXTEND.md,均不存在则使用默认值。
使用方式:先由 Claude 完成内容分析与格式化(步骤 1-6),再运行脚本做排版修复(步骤 7)。输出文件命名为 {original-filename}-formatted.md,若已存在则先按时间戳备份。运行命令:npx -y bun ${SKILL_DIR}/scripts/main.ts {output-file-path} [options]。选项包括 --quotes/-q、--no-quotes、--spacing/-s、--no-spacing、--emphasis/-e、--no-emphasis、--help/-h,默认启用 spacing 与 emphasis,禁用引号替换。脚本默认修复 CJK 强调与加粗标点问题、通过 autocorrect 添加 CJK/英文混排空格,并始终格式化 frontmatter YAML。
流程要点:检测内容类型,已有 Markdown 时询问是优化格式、保留原格式还是仅做排版修复;纯文本直接进入格式化。frontmatter 中 title 若已存在则正文不再保留 H1,slug 可从文件路径推断,summary 生成 100-150 字符,coverImage 检查同目录 imgs/cover.png。
适用场景:需要统一 Markdown 排版、补全 frontmatter 或改善中英混排的文章整理。
限制:需要 npx 与 bun 环境;保留原文风格与观点,不修改文字、不添加原文没有的内容;避免过度格式化。价格、平台兼容范围等资料暂未提供。