SuperAPI AI 工具集

baoyu-format-markdown

通用与其它

查看项目

更新于 10-15 21:47

技能介绍

用途:把纯文本或 Markdown 转换成结构清晰、便于阅读的 Markdown,帮助读者快速抓住要点与结构。核心原则是只调整格式并修复明显错别字,绝不新增、删除或改写内容。

主要能力:补全或创建 YAML frontmatter(title、slug、summary、description、coverImage);分析内容并优化标题层级、加粗关键结论、把并列信息提取为列表、把对比数据转为表格、标注代码与命令、添加引用块与分隔符;运行排版脚本修复 CJK 强调符号、添加 CJK/英文间距、替换引号、格式化 frontmatter。

使用方式:工作流分两阶段——分析(理解内容)与格式化。步骤为读取并检测内容类型、从读者视角分析内容、检查或创建 frontmatter/标题/摘要、应用格式化、保存为 {original-filename}-formatted.md、执行排版脚本、输出完成报告。脚本位于 scripts/ 子目录,主入口为 scripts/main.ts,需解析 ${BUN_X} 运行时(已装 bun 用 bun;有 npx 用 npx -y bun;否则建议安装 bun)。命令示例:${BUN_X} {baseDir}/scripts/main.ts article.md,可选参数 --quotes、--no-quotes、--spacing、--no-spacing、--emphasis、--no-emphasis。

配置:按优先级查找 EXTEND.md(项目 .baoyu-skills/baoyu-format-markdown/、XDG 配置目录、用户主目录),支持 auto_select、auto_select_title、auto_select_summary 等选项,默认均关闭,未找到配置时使用默认值,无需首次设置。

适用场景:整理文章、笔记、文档等纯文本或 Markdown,提升可读性并统一排版。

限制:不改变原文内容与作者语气;不新增解释性文字;标题与摘要生成依赖当前运行时提供的用户输入工具,缺失时改用编号纯文本询问;具体收费、价格、平台支持等信息资料暂未提供。