产品文章、开源项目文章和教程文章,最容易出现三类信息:
- 两个方案怎么选
- 这次版本更新了什么
- 读者下一步可以看哪些资源
如果这些内容都用普通段落写,读者很难收藏,也不容易被搜索和 AI 答案引用。
comparison-table、changelog、resource-list 适合把它们整理成结构化内容。
先看分工
comparison-table:两个方案的优劣对照。changelog:一次版本更新的新增、调整、修复和移除。resource-list:一组延伸资料或工具说明;模块本身不生成外部链接。
它们都是 GEO 友好模块,因为结构清楚,容易被 Agent 摘要和引用。
comparison-table:只比较两边,不做复杂表格
当你只需要比较两个选项时,用 comparison-table。
:::comparison-table
{"left":{"title":"免费排版工具","items":["适合简单文章","上手快","不适合稳定品牌识别"]},"right":{"title":"md2wechat","items":["支持高级模块","适合 Agent 工作流","能接 API 和 CLI 发布链路"]}}
:::
适合:
- 免费工具 vs md2wechat
- 手工排版 vs Agent 工作流
- API 接入 vs CLI 接入
- 旧方案 vs 新方案
不适合:
- 三个以上方案
- 多列能力矩阵
- 大量参数对比
多方案多列对比,请用 matrix。
changelog:让版本更新变得可扫读
当你介绍一次产品更新时,用 changelog。
:::changelog
{"version":"v2.9.0","date":"2026-06-26","added":["新增 title suggest --json","新增 title/wechat-title-expert prompt catalog","capabilities --json 暴露 title_generation"],"changed":["Agent 可以把标题建议交给宿主模型执行"],"fixed":["减少标题生成阶段的上传、写回和草稿副作用"],"removed":[]}
:::
适合:
- 产品版本更新
- 插件更新
- API 更新
- 开源项目 release note
注意:
added写新增能力changed写行为变化fixed写修复问题removed没有内容可以留空数组
resource-list:把资源说明变成可收藏资产
普通资源清单很容易被跳过。resource-list 更适合在教程结尾集中说明资源名称、用途和识别图标。
:::resource-list
[{"name":"md2wechat-skill CHANGELOG","desc":"查看 md2wechat-skill 从 v2.1.0 到 v2.9.0 的更新历史","icon":"📘"},{"name":"6 月更新总览","desc":"了解 v2.5.0 到 v2.9.0 的主题、多账号、图片计划和标题建议","icon":"🧭"},{"name":"API 文档","desc":"查看 Convert API 与 Publishing API 接入说明","icon":"🔌"}]
:::
适合:
- 延伸阅读
- 工具推荐
- 文档入口
- 案例合集
- 资料包说明
三个模块怎么组合
开源项目更新文章
推荐顺序:
changelog先列版本变化comparison-table解释新旧差异resource-list归纳文档和仓库用途
产品选型文章
推荐顺序:
comparison-table先讲选择question回答疑问resource-list说明下一步可用资源
教程文章
推荐顺序:
definition解释概念resource-list放资料cta引导试用或咨询
给 Agent 的提示词
请把方案对比写成 comparison-table,只比较两边。
请把版本更新写成 changelog,字段包含 version、date、added、changed、fixed、removed。
请把资源说明写成 resource-list,每个资源只包含 name、desc、icon。
输出必须是合法 JSON。
常见错法
- 用
comparison-table比较三四个方案 changelog只写新增,不写影响resource-list只有名称,没有用途说明
结构化模块让读者更容易保存和复用。
下一步
如果你需要多列方案对比、短流程或双人问答,可以继续读: