SuperAPI AI 工具集

baoyu-format-markdown

通用与其它

查看项目

更新于 10-16 00:04

技能介绍

用途:将纯文本或已有 Markdown 文件整理成结构清晰的 Markdown,补充 frontmatter、标题、摘要、标题层级、加粗、列表、代码块,并做排版规范化。

主要能力:内容类型检测(识别 frontmatter、标题、加粗、列表、代码块、引用等判断是 Markdown 还是纯文本);检查或创建 YAML frontmatter(title、slug、summary,若同目录存在 imgs/cover.png 则写入 coverImage);标题处理(已有 title 则正文不再出现 H1,首行 H1 则移入 frontmatter,否则生成 3 个候选标题供选择);格式化处理(标题层级、关键点加粗、并列项转列表、代码用行内或代码块、引用用 blockquote、适当使用分隔线);保存为 {原文件名}-formatted.md,若已存在则先用时间戳备份;执行排版脚本修正 CJK 强调标点、通过 autocorrect 添加中英混排空格、可选替换 ASCII 引号为全角引号、格式化 frontmatter YAML。

使用方式:先按优先级检查 EXTEND.md 偏好文件,项目级为 .baoyu-skills/baoyu-format-markdown/EXTEND.md,用户级为 $HOME/.baoyu-skills/baoyu-format-markdown/EXTEND.md,存在则读取并应用设置,否则使用默认值。步骤 1-6 由模型完成内容分析与格式化,随后必须运行:npx -y bun ${SKILL_DIR}/scripts/main.ts {输出文件路径} [options]。常用选项:--quotes/-q 替换引号(默认关闭);--no-quotes 不替换;--spacing/-s 添加中英空格(默认开启);--no-spacing 不添加;--emphasis/-e 修正 CJK 强调标点(默认开启);--no-emphasis 不修正;--help/-h 帮助。相关脚本:scripts/main.ts 主入口,scripts/quotes.ts 引号替换,scripts/autocorrect.ts 中英空格。

适用场景:用户要求“格式化 markdown”或希望把杂乱纯文本、草稿整理为规范 Markdown 时。

限制:格式化只添加排版,不修改原文观点、不添加原文没有的内容,需避免过度格式化;EXTEND.md 支持默认格式化选项与摘要长度偏好,其余细节资料暂未提供。