文档编辑器
表格与图片
把表格和图片当成信息表达结构,而不是装饰元素。
表格和图片最容易被用成“看起来更丰富”的装饰,但在文档里它们应该服务于信息组织。表格适合对比、参数、状态和字段;图片适合截图、示意图和流程补充。两者都应帮助读者更快理解,而不是制造额外阅读负担。
Steps
- 先判断信息是“可比较的”,还是“需要看图的”
- 让表格列名和图片说明可独立理解
- 给图片补齐替代文本和上下文
- 避免把正文主信息藏进截图
先判断信息是“可比较的”,还是“需要看图的”
如果内容是字段、参数、版本差异、角色权限、状态矩阵,优先用表格。若内容依赖界面布局、视觉状态、流程截图或示意图,优先用图片。不要把本来能写成表格的内容做成文字截图。
让表格列名和图片说明可独立理解
表格至少应让列名本身有意义,读者不看上下文也能大致知道每列在说什么。图片则应配合清晰的说明文字或上下文段落,告诉读者这张图在证明什么,而不是只把图片丢在页面里。
给图片补齐替代文本和上下文
图片不应只有视觉本身。尽量补齐 alt 文本,并在正文中解释图片用途。对公开站点和 AI 消费来说,图片上下文越清楚,越不容易沦为“只对人眼可读”的孤岛。
避免把正文主信息藏进截图
大量文字说明、配置值或命令,不应主要存在于截图里。真正要被搜索、复制、索引和机器读取的信息,仍应保留在正文、表格或代码块中;图片更适合做辅助证明而不是唯一载体。
推荐场景: 表格适合参数说明、能力对比、版本支持表;图片适合 UI 截图、架构草图、流程示意。
公开可读性: reader、plainText 与机器可读产物更擅长消费正文和表格文本。图片如果缺少上下文,会显著降低公开可读性和 AI 可用性。