Agent Skills
返回列表
💻

Markdown Front Matter 拆分器

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_3c6cb52e/split-markdown-front-matter-and-body-before-docs-migrations-metadata-audits-or-static-site-transforms。

技能介绍

当你需要把 Markdown 拆成元数据与正文

文档迁移、元数据审计或静态站点转换时，front matter 和正文通常要分别处理：迁移时要保留原文件的元数据，审计时要提取 title、date、tags，转换时只要干净正文。直接整体读取文件，会让后续步骤被格式问题干扰。

技能做了什么

这个技能聚焦安全解析和重写，不是完整 CMS 或静态站生成器。它引入 gray-matter，把结构化 front matter 解析出来，并把正文清理后交给下一步。工作流程包括：读取 Markdown 或内容文件；提取结构化元数据；输出干净正文与 metadata。

适用边界与注意事项

适合已经存在 Markdown 文件、需要可重复拆分用于迁移或审计的场景。它不负责站点构建或发布流程。注意 gray-matter 版本变化，并确认文档约定，保证解析路径稳定。

使用场景

  • 文档迁移前，需要保留每篇 Markdown 的标题、日期等元数据并输出干净正文，避免迁移时格式错乱。
  • 元数据审计时，需要从多个内容文件中提取结构化 front matter，用于后续统计、分类和检查。
  • 静态站点转换时，需要把原文档拆成元数据和正文，分别用于页面配置与正文渲染。
  • 编写脚本时，需要按一致约定把 Markdown 文件拆成 metadata 和 body，供后续处理流水线消费。

适合人员

  • 文档工程师，需要在迁移前批量拆分 front matter 和正文，保证内容进入新站点时结构稳定。
  • 元数据审计人员，需要从现有 Markdown 中抽取 title、date 等字段，用于清点、核对和整改。
  • 静态站点开发者，需要在转换器里获得干净的正文和结构化元数据，分别用于渲染与页面配置。
  • 后端工程师，需要把 Markdown 拆分步骤接入迁移或导入流程，减少后续解析成本。