跳到主要内容

模块教程 / FIELD NOTES

选型、更新日志和资源合集怎么排?comparison-table、changelog、resource-list 用法

产品文章最容易写散:一会儿讲对比,一会儿讲更新,一会儿丢链接。comparison-table、changelog、resource-list 能把这三类信息整理成读者可收藏的结构。

产品文章、开源项目文章和教程文章,最容易出现三类信息:

  • 两个方案怎么选
  • 这次版本更新了什么
  • 读者下一步可以看哪些资源

如果这些内容都用普通段落写,读者很难收藏,也不容易被搜索和 AI 答案引用。

comparison-tablechangelogresource-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":"🔌"}]
:::

适合:

  • 延伸阅读
  • 工具推荐
  • 文档入口
  • 案例合集
  • 资料包说明

三个模块怎么组合

开源项目更新文章

推荐顺序:

  1. changelog 先列版本变化
  2. comparison-table 解释新旧差异
  3. resource-list 归纳文档和仓库用途

产品选型文章

推荐顺序:

  1. comparison-table 先讲选择
  2. question 回答疑问
  3. resource-list 说明下一步可用资源

教程文章

推荐顺序:

  1. definition 解释概念
  2. resource-list 放资料
  3. cta 引导试用或咨询

给 Agent 的提示词

请把方案对比写成 comparison-table,只比较两边。
请把版本更新写成 changelog,字段包含 version、date、added、changed、fixed、removed。
请把资源说明写成 resource-list,每个资源只包含 name、desc、icon。
输出必须是合法 JSON。

常见错法

  • comparison-table 比较三四个方案
  • changelog 只写新增,不写影响
  • resource-list 只有名称,没有用途说明

结构化模块让读者更容易保存和复用。

下一步

如果你需要多列方案对比、短流程或双人问答,可以继续读:

继续阅读

公众号高密度内容怎么排?callout、quote-card、stat-row 使用指南

如果正文信息很多,但读者看完记不住重点,先不要继续加大标题。callout、quote-card、stat-row 更适合把提醒、判断和关键数字变成清楚的阅读停顿点。

术语、社交证明和问答怎么排?definition、tweet、question 三个模块的用法

术语解释、用户反馈和常见问题,本质上都在降低理解成本。definition、tweet、question 适合把这些内容从正文里拎出来,让读者更快建立信任。

自由布局模块怎么用?split、flow、matrix、dialogue-pair 的最新推荐语法

自由布局用来处理复杂内容。split 负责左右信息,flow 负责短流程,matrix 负责多方案对比,dialogue-pair 负责双人视角。

YOUR NEXT ARTICLE

让下一篇文章,从清楚的排版开始。

先看效果,再把稳定的排版能力接入你的工作流。

选型、更新日志和资源合集怎么排?comparison-table、changelog、resource-list 用法