用途:把纯文本或已有 Markdown 文件转换为结构清晰、排版规范的 Markdown,适合整理草稿、文章与笔记。
主要能力:检测内容类型(纯文本或 Markdown);检查并创建 YAML frontmatter,处理 title、slug、summary、coverImage 等字段;提取或生成标题(正文不再重复 H1);按层级使用 #、##、###,将要点加粗、并列内容转为列表、代码用行内或代码块、引用用 >;保存为 {原文件名}-formatted.md,覆盖前按时间戳备份。
排版脚本:scripts/main.ts 为主入口,另有 scripts/quotes.ts(ASCII 引号转全角)与 scripts/autocorrect.ts(中英文间距)。运行命令:npx -y bun ${SKILL_DIR}/scripts/main.ts {输出文件路径} [选项]。选项包括 --quotes/-q、--no-quotes、--spacing/-s(默认开启)、--no-spacing、--emphasis/-e(默认开启)、--no-emphasis、--help/-h。脚本默认修复 CJK 强调标点、添加中英文间距,引号替换默认关闭,frontmatter YAML 始终格式化。
配置:通过 EXTEND.md 自定义,优先项目级 .baoyu-skills/baoyu-format-markdown/EXTEND.md,其次用户级 $HOME/.baoyu-skills/baoyu-format-markdown/EXTEND.md;未找到则用默认值。支持默认格式化选项与摘要长度偏好。
使用流程:读取源文件→检测类型并确认(Markdown 时可选优化格式、保留原格式或仅排版修正)→分析结构→检查/创建 frontmatter→处理标题→格式化→保存→运行脚本→展示结果。
限制:仅添加格式,不修改原文内容与观点,不添加原文没有的内容;需 bun 运行环境,缺失时应停止并返回安装命令。其他细节暂未提供。