Markdown 到 AMP 文章转换器
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_3c6cb52e/markdown-to-amp-article-converter。
技能介绍
要解决的问题
技术团队常把技术稿、发布说明和复现步骤写在 Markdown 里,但直接放进 AMP 页面并不保险:手工补 AMP 标签容易漏掉 <amp-img>、<amp-fit-text> 等约束,模板一改又会污染正文。这个技能面向 Markdown 到 AMP 文章 的单向转换,目标是让源稿保持 Markdown 的写作和评审习惯,同时产出可交给 AMP runtime 消费的 HTML。
工作方式
- 解析 Markdown 后先走 unified / remark / rehype 管线,把文档逐步变成可操作的语法树,再输出 HTML。
- 转换时围绕文章结构补齐 AMP 所需标记,而不是简单把 Markdown 原样包进一个模板。
- 输出会用
amphtml-validator做校验,用校验结果拦截明显不合规的标签、属性或缓存布局问题。 - 同时通过
schema-dts生成结构化数据,方便下游声明文章类型,而不是把元信息散落在正文里。
适用边界
适合流程中已有清晰 Markdown 源、需要固定 AMP 文章产物的工程化场景,例如静态站点生成前的转换环节。它解决的是“转换 + 校验 + 结构化数据”这条链路,不是通用网页编辑器,也不负责替换完整 CMS 的路由、发布审批或富媒体资产管理。
上游项目没有提供可自动抽取的 source-backed install / usage instructions;如果在 CI、线上发布或其他敏感流程中使用,应先 review 上游仓库,确认插件版本、参数和输出策略符合你的安全要求。
使用场景
- 在 Markdown 技术稿进入发布流程前,需要批量转成符合 AMP 约束的 HTML 文章。
- 已有 Markdown 发布说明,要生成带 schema-dts 结构化数据的 AMP 页面内容。
- 站点接入 AMP 后,需要检查 Markdown 转换结果是否通过 amphtml-validator。
- 技术博客准备归档为 AMP 文章,需要统一正文结构和元数据输出格式。
适合人员
- 负责技术内容发布的前端工程师:需要把 Markdown 稿件稳定转成 AMP HTML。
- 维护 AMP 站点的开发者:想自动获得可校验的文章输出和结构化数据。
- 内容平台工程师:需要把 Markdown 文档转换成符合 AMP 规范的文章产物。
- 技术写作平台维护者:要为 Markdown 到 AMP 的转换结果增加校验和 schema。