用途:把纯文本或已有 Markdown 文件整理成结构良好的 Markdown,包含 frontmatter、标题、摘要、标题层级、加粗、列表与代码块,并做排版修正。
主要能力:内容类型检测(依据 frontmatter、标题、加粗、列表、代码块、引用等判断纯文本或 Markdown);生成或补全 YAML frontmatter(title、slug、summary、coverImage);标题处理(已有 title 则正文不再保留 H1,首行 H1 则提取到 frontmatter,否则生成候选标题供选择);格式化处理(标题层级、加粗、列表、行内与块代码、引用、分隔线);排版脚本修正 CJK 强调标点、中英混排间距、ASCII 引号替换与 frontmatter YAML 格式化。
使用方式:脚本位于 scripts/ 子目录,用 ${SKILL_DIR} 替换为 SKILL.md 所在目录。主入口为 scripts/main.ts,另有 scripts/quotes.ts 与 scripts/autocorrect.ts。执行命令: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,quotes 默认关闭。可通过 EXTEND.md 自定义配置,优先检查项目级 .baoyu-skills/baoyu-format-markdown/EXTEND.md,其次用户级 $HOME/.baoyu-skills/baoyu-format-markdown/EXTEND.md,未找到则用默认值。
适用场景:整理草稿、统一文章排版、为发布准备带 frontmatter 的 Markdown。
限制:仅做格式化,不修改原文观点、不添加原文没有的内容;输出文件为 {filename}-formatted.md,覆盖前会按时间戳备份;具体收费、平台与效果资料暂未提供。