SuperAPI AI 工具集

baoyu-format-markdown

通用与其它

查看项目

更新于 10-15 21:56

技能介绍

用途:将纯文本或 Markdown 转换为结构清晰、便于阅读的 Markdown,帮助读者快速抓住重点与结构,同时不改变原文内容。

主要能力:检测内容类型(Markdown 或纯文本);分析内容亮点、结构、读者关注信息与格式问题;检查或创建 YAML frontmatter(title、slug、summary、description、coverImage);生成并让用户选择标题;生成 summary 与 description;按需添加标题层级、加粗、列表、表格、代码标记、引用与分隔线;修正明显错别字;最后运行排版脚本处理 CJK 强调标点、中英文间距与引号替换。

使用方式:技能工作流分分析(步骤 1-5)与排版(步骤 6)两阶段。若检测到已有 Markdown 格式,会询问用户选择优化格式、保留原格式或仅做排版修正。分析结果保存为 {original-filename}-analysis.md,格式化结果保存为 {original-filename}-formatted.md,已存在同名文件会先备份。排版脚本位于 scripts/ 子目录,运行命令为 ${BUN_X} {baseDir}/scripts/main.ts {output-file-path} [options],其中 ${BUN_X} 在安装 bun 时为 bun,否则为 npx -y bun。常用选项:--quotes/-q 替换 ASCII 引号为全角引号(默认关闭)、--spacing/-s 添加中英文间距(默认开启)、--emphasis/-e 修复 CJK 强调标点(默认开启),可用 --no-quotes、--no-spacing、--no-emphasis 关闭。

配置:可通过 EXTEND.md 自定义,按项目、XDG、用户主目录顺序查找,首个命中生效;支持 auto_select、auto_select_title、auto_select_summary 等设置,默认均为 false,未找到配置时使用默认值,无需首次设置。

适用场景:需要把草稿、笔记或已有 Markdown 整理为发布级排版时使用。

限制:只调整格式与修正明显错别字,不添加、删除或改写内容;不添加带主观评价的标题;不过度格式化。具体平台、收费与效果资料暂未提供。