用途:把纯文本或 Markdown 文件转换为结构良好的 Markdown,补充 YAML frontmatter、标题、摘要(100-150 字符)、标题层级、加粗、列表、代码块与引用等格式,并做排版修正。
主要能力:内容类型检测(有 YAML frontmatter、标题、加粗、列表、代码块、引用等视为 Markdown,否则为纯文本);frontmatter 处理,包括 title、slug、summary、coverImage(同目录 imgs/cover.png 存在时使用相对路径,也接受 featureImage);标题处理,若首行为 H1 则提取到 frontmatter 并从正文删除,若无标题则生成 3 个候选标题供选择,标题不超过 20 字;排版脚本可修中文强调标点、通过 autocorrect 增加中英文间距、把 ASCII 引号替换为全角引号、格式化 frontmatter YAML。
使用方式:技能由 Claude 先做内容分析与格式化(步骤 1-6),再执行排版脚本(步骤 7)。排版命令为:npx -y bun ${SKILL_DIR}/scripts/main.ts {output-file-path} [options]。可选参数:--quotes/-q 替换引号(默认 false)、--no-quotes、--spacing/-s 增加中英文间距(默认 true)、--no-spacing、--emphasis/-e 修中文强调(默认 true)、--no-emphasis、--help/-h。若检测到输入已是 Markdown,会询问用户选择:优化格式(推荐)、保留原格式、仅做排版修正。输出文件命名为 {filename}-formatted.md;若该文件已存在,先用 mv 备份为 {filename}-formatted.backup-$(date +%Y%m%d-%H%M%S).md。
配置:通过 EXTEND.md 自定义。优先级为项目级 .baoyu-skills/baoyu-format-markdown/EXTEND.md,其次用户级 $HOME/.baoyu-skills/baoyu-format-markdown/EXTEND.md;不存在则用默认值。可配置默认格式化选项与摘要长度。
限制:排版脚本依赖 npx 与 bun;格式化只增加格式、不修改原文内容与观点,不添加原文没有的内容,需避免过度格式化;引用、收费、价格、平台等未提供。