SuperAPI AI 工具集

canghe-format-markdown

通用与其它

查看项目

更新于 10-15 21:47

技能介绍

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

主要能力:内容类型检测(依据 frontmatter、标题、加粗、列表、代码块、引用等判断纯文本或 Markdown);生成或补全 YAML frontmatter(title、slug、summary、coverImage);标题处理(已有 title 则正文不再保留 H1,首行 H1 提取到 frontmatter,否则生成候选标题);格式化处理(标题层级、加粗、列表、行内与块级代码、引用、分隔线);排版脚本修复 CJK 强调标点、中英混排间距、可选全角引号替换。

使用方式:脚本位于 scripts/ 子目录,用 ${SKILL_DIR} 替换为 SKILL.md 所在目录。主入口为 scripts/main.ts,另有 scripts/quotes.ts 与 scripts/autocorrect.ts。执行命令:npx -y bun ${SKILL_DIR}/scripts/main.ts {output-file-path} [options]。选项包括 --quotes/-q、--no-quotes、--spacing/-s、--no-spacing、--emphasis/-e、--no-emphasis、--help/-h。默认启用 spacing 与 emphasis,quotes 默认关闭。可通过 EXTEND.md 配置默认格式化选项与摘要长度,优先检查项目级 .canghe-skills/canghe-format-markdown/EXTEND.md,其次用户级 $HOME/.canghe-skills/canghe-format-markdown/EXTEND.md。

适用场景:整理草稿、统一文章排版、为发布内容补 frontmatter 与摘要、修复中英混排与 CJK 强调问题。

限制:格式化只添加结构、不修改原文内容与观点;输出默认保存为 {原文件名}-formatted.md,覆盖前会按时间戳备份;若选择仅排版修复则直接修改原文件;具体平台与收费信息暂未提供。