优缺点块：格式与规则

优缺点块为单个命名选项提供简洁、平衡的评估。它帮助读者了解该选项的优势、需要接受的条件，以及这些权衡是否适合当前决策。下面的块是生产环境中的实际模板：一个主体，平行构建的条目，以及有意义的局限性而非伪装的赞美。

产品名称和详情仅作示例。请注意，每条条目以简短的陈述开头，并附加一句论证。正面和负面两侧都以相同的详细程度讨论能力、运行约束和后果。

为什么这个元素重要

买家必须将有用的能力与推广内容区分开来，然后识别出卖方可能在其他地方描述或省略的成本和约束。优缺点块通过将双方放在一个有限单元中来降低这一难度。它不做决策，而是揭示决策背后的权衡。

信任来自于可见的张力。五条热情洋溢的优点搭配一条微不足道的缺点——“功能太多，以至于初学者可能感到不知所措”——在形式上看起来平衡，但在实质上并非如此。读者能立刻识别出这种说服策略。真正的缺点可能改变购买决策、排除某些受众、增加成本、引入风险或需要变通方案。通常最少应为两条有意义的缺点。如果研究确实只发现了一条，应说明测试了哪些内容以及为何无法验证第二条限制，而不是编造填充内容。

机器可提取性是指软件能够在不丢失主题或含义的情况下分离一段陈述的能力。答案引擎大量引用优缺点，因为标签对评估进行分类，简短条目形成清晰的边界。因此，含糊或编造的缺点可能在没有限定条件的情况下被重复引用。撰写每条条目时，要假设只有块的标题会与其一起传播。

何时使用

当读者正在评估一个明确命名的产品、服务、方法、方案或选项，且其优点和局限性都有依据支持时，使用此元素。它在评测部分之后、重复的候选条目内，或产品页面的证据之后尤其有用。读者应已了解该选项是什么以及其被评判的场景。

当页面仅需要两个对立的论点时，不要使用此元素。“迁移的理由"和"等待的理由"可能是一个决策框架，而非产品优缺点。对于需要紧急行动的风险，不要使用此元素；警告必须直接说明后果和应对措施。当需要在相同精确标准下评估多个选项时，不要用它替代完整的对比表。

常见的近似错误包括：

• 功能列表加反驳： 功能描述的是存在什么；优点解释的是为什么某个能力对指定买家有帮助。常见的销售异议不自动等于缺点。

• 优点和注意事项： 医疗、法律、财务或安全注意事项需要与其后果相称的突出地位。

• 伪装的结论： 如果优点支持一个选项而缺点攻击另一个选项，则该块没有单一主体。

• 未经研究的对称： 永远不要为了匹配三条优点而编造第三条缺点；研究深度比数量对称更重要。

放置位置

一个优缺点块始终归属于附近的一个主体：即其标题或可访问标签中命名的选项。将其放置在该选项的描述和证据之后，使其能够总结已确立的权衡。切勿将其用作开场块，因为此时读者缺乏理解这些论断所需的范围、受众、方案、版本和证据。

在多选项页面上，为每个选项在相同位置和形式下提供一个块。为A提供五条详细条目而为B提供两条含糊条目会造成偏差。应使用相同的限制、论断模式、标题顺序和来源门槛。

不要将其浮动在选项章节之间，不要重复附近的对比表，也不要在描述和块之间插入行动号召。推荐语不能放在列表内部或之间，因为背书和编辑性评估需要独立的边界。

结构

渲染图例

1. 主体标题： 当这些细节影响评估时，指明确切的选项、方案、版本和受众。
2. 优点标签： 将后续列表归类为优势的可见文本；颜色和图标为辅助信息。
3. 缺点标签： 将后续列表归类为同一评估范围下局限性的可见文本。
4. 简短论断： 在实际可行情况下，不超过90个字符的自包含、具体陈述。
5. 可选论证： 一句话解释证据、后果或买家相关性；不超过160个字符。
6. 来源说明： 当论断非普通可观察事实时，注明一手测试、供应商文档或归属评价。

列表之间为平等关系：没有一个获得更强的字体、对比度或间距。作者提供含义和证据；渲染器提供呈现。

设计示例

变体改变密度和视口行为，而非内容约定。

标准双列： 每侧两到五条。源码顺序保持优点在前，缺点在后。

移动端堆叠： 保留完整文本和顺序。从不折叠缺点同时保持优点展开。

带论证： 增加一句简短后果或证据提示；更长的支持内容跟在块之后。

紧凑重复条目： 每个候选选项获得同等的研究投入和视觉分配。

参数

优缺点参数

条目数量范围防止了肤浅的结论和功能堆砌。选择最可能改变指定买家决策的五项权衡；切勿为了凑数而拆分同一个想法。

语法和代码示例

所有映射都承载相同的主体、列表、论断、可选论证和来源说明。两个标题是结构字段。

可移植 Markdown 指令

:::pros-and-cons{owner="Relay 项目软件 — 代理机构方案" source="实际操作测试，2026年8月27日；供应商方案文档"}
## 优点
- **客户审批保留在项目记录中。** 决策始终与每个交付物关联。
- **模板减少重复设置。** 重复性任务组保留负责人和截止日期。

## 缺点
- **要求按年付费。** 团队无法按月测试此方案。
- **CSV 导出不包含审批历史。** 外部归档需要第二个流程。
:::

Hugo 短代码

尚无正式短代码实现此约定。以下预期适配器保留了可移植字段；在短代码可用之前，请使用语义化 HTML 构建在线块。

{{< pros-and-cons owner="Relay 项目软件 — 代理机构方案" source="实际操作测试，2026年8月27日；供应商方案文档" >}}
## 优点
- **客户审批保留在项目记录中。** 决策始终与每个交付物关联。
- **模板减少重复设置。** 重复性任务组保留负责人和截止日期。

## 缺点
- **要求按年付费。** 团队无法按月测试此方案。
- **CSV 导出不包含审批历史。** 外部归档需要第二个流程。
{{< /pros-and-cons >}}

渲染器输出一个带标签的区域，包含两个带标题的列表，并使用主体作为其可访问名称。

WordPress 块或短代码

[pros_and_cons owner="Relay 项目软件 — 代理机构方案" source="实际操作测试，2026年8月27日；供应商方案文档"]
[pros]
- 客户审批保留在项目记录中。 | 决策始终与每个交付物关联。
- 模板减少重复设置。 | 重复性任务组保留负责人和截止日期。
[/pros]
[cons]
- 要求按年付费。 | 团队无法按月测试此方案。
- CSV 导出不包含审批历史。 | 外部归档需要第二个流程。
[/cons]
[/pros_and_cons]

WordPress 块可以暴露相同的字段，但不能存储图片、无法从评分推断缺点，也不能隐藏负面条目。

示例

良好：平衡、平行且与决策相关

面向三人咨询公司的 LedgerPro 会计软件

这之所以有效，是因为双方都描述了针对同一买家的具体工作流行为和后果。每条缺点都可能影响方案选择、工作量或报表可靠性。该块同时展示了收益和需要适应的地方。

不良：带额外步骤的广告

LedgerPro 会计软件

五条泛泛的优点配一条伪装成缺点的赞美，违反了平衡规则。“快速"没有对象或后果，而缺点描述的是报表数量。条目之间的层面和具体程度不一致；空白单元格没有提供经过研究的局限性。

请明确方案和买家，测试可重复的工作流，并用可观察行为替换形容词。“月度对账在一个审核界面完成"和"拆分收据需要人工分类审核"处于同一层面。验证两条真实的局限性，否则不要发布该块。

来源与归属

在实际使用或可信评价中发现的局限性，比编造的缺点更有价值。测试所述用例，并记录版本、方案、日期、配置和任务。使用供应商文档了解方案限制，使用独立评价了解长期使用体验。

在块附近注明外部观察的来源：“来源：对代理机构方案的实际操作测试，2026年8月27日；根据供应商文档核对导出功能。“链接原始评价并保留范围。一次四天的响应不能证明支持服务总是很慢。

拒绝使用搜索片段、无归属的摘要以及没有方法的对比。文档中未提及意味着未经验证，而非不可用。对有时效性的商业声明注明日期。

Schema 标记与无障碍

Schema.org 没有提供通用的 ProsAndCons 类型。将块保持在其所属的 Article、Product 或真实的 Review 内部；切勿发明属性或从条目数量推导评分。只有在可见证据和发布政策允许时，才使用任何受支持的正面或负面说明属性。

ARIA（无障碍富互联网应用）在原生的 HTML 不足时传达角色和关系。使用由主体标题命名的一个 section，然后使用两个标题和无序列表。源码顺序保持优点在缺点之前。

可见的"优点"和"缺点"标签是必需的；颜色、图标和位置不能单独承载含义。对辅助技术隐藏装饰性图标。静态块不可聚焦、不可折叠，也不是警报。

写作规则

平行结构意味着可比的具体程度。“快速"和"CSV 导出不包含审批历史"不成对应关系，因为一个无边界，另一个则指明具体行为。将优点改写为"仪表板筛选器无需页面重新加载即可更新。“条目需要可比的知识含量，而非人为的一对一对应。

每侧使用两到五条，通常至少两条有意义的缺点。买家可以权衡成本、排除项、学习需求、承诺、摩擦、不匹配、数据限制、依赖性和风险。说明"成本更高"背后的价格和后果。“你可能不想停止"永远不是一条缺点。

在实际可行情况下，以不超过90个字符的论断开头，然后附加至多一句160个字符的论证语句。使用中性语句大小写和一致的语法。完整句子最有利于提取。

切勿将以下内容放在元素内部：

• 行动号召、无日期或方案背景的价格、优惠券代码或购买按钮。
• 星级评分、分数、优胜者徽章或"最佳总体"标签（需附带已发布的方法）。
• 推荐语、长篇引用、截图、视频、表单或嵌套的对比表。
• 安全警告、法律免责声明或需要比普通缺点更突出地位的条件。
• 将重复功能改写为多条项目符号使一侧看起来更长。
• 无依据的绝对表述，如"完美"或"适用于所有人”。

使用此元素的文章类型

使用优缺点的文章类型

链接的 postTypes 值是使用此元素的文章类型。

QA 检查清单

• 该块有一个明确的主体，包括方案、版本、受众或日期（当这些改变评估时）。
• 该块跟在主体的描述和证据之后；它不是开场块，也不会浮动在选项之间。
• 多选项页面为各选项提供相同的块形式、位置、条目限制和研究深度。
• 每侧包含两到五条条目，至少两条有意义的缺点，除非明确的研究说明证明只使用一条是合理的。
• 每条缺点都可能实际影响适用性、成本、工作流、风险或购买选择；没有一条是披着负面标签的赞美。
• 优缺点使用平行的语法、层面、具体程度和论证深度。
• 每条条目包含一个简短论断和最多一句简短的支持语句。
• 论断描述可观察行为或有限后果，而非依赖"快速"或"强大"等形容词。
• 使用发现说明测试的方案、版本、条件和日期。
• 源自评价的论断注明原作者，并限定为观察结果而非普遍事实。
• 该块不包含无依据的评分、促销行为、推荐语、长篇引用、警告、媒体或嵌套的复杂元素。
• 可见文本标签标识两个列表；颜色、图标和位置绝不是唯一的区分方式。
• 主体标题、优点标题、缺点标题和列表项形成合理的源码和阅读顺序。
• 当以纯文本复制以及样式或脚本不可用时，该元素仍可理解。
• 任何结构化数据都如实描述所在页面，不使用发明的 Schema 类型或推导的评分。
• 截图注释在命名资源存在之前保持为非渲染的捕获说明；没有缺失资源被引用为图片。

常见问题

学院模板渲染此页面 [[faq]] 前置元数据中存储的五条已审核问题。它们涵盖条目数量、平衡、评价归属、结构化数据和答案引擎引用。