2026-04-10
MDX 组件示例:给技术文章加结构化信息块
通过可复用组件把“结论、指标、风险”变成标准化区块,减少长文维护成本。
技术文章写到后期,经常会出现两个问题:
- 读者找不到重点结论
- 作者回看时难以快速更新关键指标
我把这两个问题拆成了两个组件。
平均写作准备时间
18 min
单篇修订轮次
2-3 轮
组件复用率
70%+
使用建议
Callout适合放置风险提醒、结论摘要、术语说明。StatGrid适合放置版本差异、实验指标、上线前后对比。- 组件数量应受控,宁可少量高复用,也不要每篇文章都造新块。