什么是内聚性在文档排版中的体现
写文档时，我们常遇到内容东一块西一块的情况。比如讲一个操作流程，步骤说明放在一页，注意事项散落在附录，图示又插在中间某个角落。读者得来回翻找，体验很差。这种结构松散的问题，本质上是内聚性不足。
内聚性指的是相关内容之间的紧密程度。高内聚意味着同一个主题下的信息集中、关联强、自成一体。在文档排版中，提升内聚性就是把该在一起的内容真正放在一起，减少用户的认知跳跃。
调整段落与模块的归属关系
常见问题是，一段技术说明后面紧跟着一个不相关的图表标题，或者一个功能描述下面突然插入另一个模块的配置项。这时候需要重新审视每个段落的归属。
比如你在写一份API接口文档，原本结构是：
<h3>用户登录</h3>
<p>调用 /api/login 接口，传入用户名和密码。</p>
<h3>错误码说明</h3>
<p>401 表示未授权，404 表示接口不存在。</p>
<h3>数据加密规则</h3>
<p>所有传输需使用 HTTPS。</p>这里“错误码说明”属于通用部分，却夹在两个具体功能之间，破坏了各自模块的完整性。更好的方式是将错误码归入独立章节，或在每个接口内部补充其可能返回的错误类型。
用视觉区块强化内容聚合
光逻辑上归类还不够，视觉上也得让人一眼看出“这是一块”。可以用边框、背景色、内边距把这些高内聚的内容包裹成独立单元。
例如：
<div class="api-block">
<h4>GET /api/profile</h4>
<p>获取当前用户个人信息。</p>
<h5>请求头</h5>
<p>Authorization: Bearer <token></p>
<h5>成功响应</h5>
<pre><code>{ "id": 123, "name": "张三" }</code></pre>
<h5>可能错误</h5>
<ul>
<li>401 - 登录失效</li>
<li>403 - 权限不足</li>
</ul>
</div>这样每个接口自包含，读者不需要跳转到其他区域就能掌握全部信息。就像便利店把泡面、火腿肠、热水壶都摆在一块，买的人顺手就拿齐了。
避免跨区域依赖
有些文档喜欢写“详见第三章第五节”，或者“参考附录B”。这类引用本身没问题，但如果频繁出现，说明内容被不合理地拆分了。
如果某个概念在多个地方被反复引用，不如把它单独拎出来做成小贴士卡片，然后嵌入到各个相关模块中。虽然看起来有点重复，但换来了每个模块的独立完整，反而降低了理解成本。
比如“JWT令牌格式”这种通用知识，可以在用户登录、权限校验、接口调试等多个章节里都简要提一句，并指向同一个术语解释浮层，而不是硬生生割裂出去。
通过命名增强语义关联
文件名、标题、样式类名这些细节也能提升感知上的内聚性。比如一组操作步骤使用相同的前缀：
<h3>步骤一：准备环境</h3>
<h3>步骤二：安装依赖</h3>
<h3>步骤三：启动服务</h3>或者给同一类提示信息使用统一的类名：
<div class="tip warning">注意网络连接状态</div>
<div class="tip warning">确保配置文件已保存</div>这种一致性会让读者自然形成“它们是一伙的”印象，即使分布在不同页面，也能通过样式快速识别关联性。
内聚性不是追求绝对的最小化模块数量，而是让每一个模块都“说得清楚自己的事”。当你调整排版时，多问一句：这部分内容能不能独立被人看懂？还需要不需要到处翻找上下文？答案会指引你做出更合理的布局选择。