作者：周智
人类在发明文字媒介之前，用的是图形符号。图像（或图形、图片）是所有内容表达方式中最直观的一种，同时也能提升读者的阅读兴趣。有人专门做过研究：在文档中增加图像能提升读者对文档的喜爱程度，不管这个图像跟文档内容本身是否有关系。也就是说，哪怕在文档中插入无关紧要的图像，读者也更愿意去尝试阅读文档中其他的内容。我们平时看别人演示PPT时，如果发现整页都是文字描述，大概率就不会有认真去听的欲望。下面是一段对双向链表的文字描述：
|
× |
|
双向链表也叫双链表，是链表的一种。它的每个数据节点中都有两个指针，分别指向直接后继节点和直接前驱节点。所以，从双向链表中的任意一个节点开始，我们都可以很方便地访问它的前驱节点和后继节点。在应用双向链表时，我们一般构造双向循环链表，链表首尾相连。 |
上面这段描述双向链表的文字本身已经非常清晰，对数据结构有一定基础的人看完文字基本就能理解双向链表的结构和应用场合（基于它的特点）。但是，如果是一个零基础的小白来看这段话，可能效果就不会太好（尤其如果这段话是作为PPT中的内容，大概不会再有更多的内容补充）。如果我们在这段话后面增加一个插图，来直观告诉读者双向链表长什么样：
|
√ |
|
双向链表也叫双链表，是链表的一种。它的每个数据节点中都有两个指针，分别指向直接后继节点和直接前驱节点。所以，从双向链表中的任意一个节点开始，我们都可以很方便地访问它的前驱节点和后继节点。在应用双向链表时，我们一般构造双向循环链表，链表首尾相连。下图是双向链表结构示意图：
双向链表结构 |
上面的文本配合图片，能让读者更加直观地理解双向链表的结构特点。当文档中的文本和图片同时出现时，读者大概会先看图片，然后再结合文字去理解，加快文档阅读速度。
可抽象也可具体
技术型文档中的插图不一定都是流程图、架构图、或者结构设计图这种非常具体的技术相关图片，还可以是抽象的、能形象表达文档主题的图片。下面是在技术性文档中使用卡通和漫画图片的示例：
|
√ |
|
<示例1>Gitlab中有Label和Tag两个概念。
为了便于区分，这里将Label翻译成“标签”，将Tag翻译成“标记”（在有些地方这两个单词翻译并没有严格的差异）。Gitlab中标签的作用是为了分类、快速地检索和过滤，用户能通过标签来直观的管理Issues，比如to-do、bug等等。标记的主要作用是为了归档，给Commit取一个形象的别名，后期快速定位和查找。 Gitlab中创建标记可以理解为“做记号”，建立索引。一般推荐为标记定义一个有意义的名称，比如以版本号为名，当我们要发布1.0版本，对应的标记名称可以是“v1.0”，如果我们要发布2.0预览版，那么对应的标记名称可以是“2.0-pre”。 <示例2>源码版本控制系统（Source Code Version Control System）主要负责对源代码版本进行管理，涉及到代码提交、撤销、比对、分支管理、代码合并等功能。源码管理是软件开发过程中非常重要的一个环节，它能有效保证软件代码质量。
团队协作 源码管理并不是软件开发周期的全部，整个软件开发周期涉及到多个流程、多个团队（多人）协作完成，包括立项/结项、进度/任务管理、需求/设计、bug管理、测试、集成上线等环节。 |
突出图中重点
当我们想为文档添加图片时，单张图片包含的内容不宜太过复杂，图片应该能准确地表达意思。如果一张图太过复杂、或者包含了一些可能引起歧义的部分，我们可以尝试以下两种改进方式：
将复杂的图拆开，一张图对应一个局部细节；在图片中将重点区域标记出来，让读者可以一眼就发现重点。
在技术型文档中插入复杂的系统架构图很常见，这种时候建议遵循“先宏观，再具体”的原则，循序渐进。我们不要一上来就放一张大图，还想将所有的细节都包含进去，这种想法不太现实，这不仅对你画图的技能要求很高，读者看完也容易一脸懵。下面这张图太过复杂：
|
× |
|
整个视频分析系统由3大服务组成，分别是Intelligent Video Analytics、Front Video Service以及Distribute Load Balance，这3大服务一共包含15个子模块。下面是视频分析系统结构：
视频分析系统结构 |
上面这个例子中插入的这张图既想描述3大服务之间的交互关系、又想描述各个服务内部子模块之间的交互关系（上面只是示意图，实际情况可能比这个更复杂）。文档读者碰到这种情况可能会产生两个感觉：一是图太复杂了，很难看懂，有些地方迫于空间原因字号还小；二是我需要重点关注的点在哪里？如果遵循前面提到的“先宏观，再具体”的原则，上面这个例子可以调整为：
|
√ |
|
整个视频分析系统由3大服务组成，分别是Intelligent Video Analytics、Front Video Service以及Distribute Load Balance。下面是视频分析系统中各服务之间的关系：
视频分析系统服务交互 其中，Intelligent Video Analytics服务主要负责对视频解码、推理以及行为分析等结构化操作。该服务内部一共包含9个子模块，模块之间的关系见下图：
服务子模块交互 Front Video Service服务主要负责视频接入、分发、配置管理等功能。该服务内部一共包含3个子模块... |
另外一种情况，插入的图片中包含了不相干内容，文档作者又没有给出醒目的标记，读者看完不清楚关注重点在哪里。下面是错误的示例：
|
× |
|
Gitlab中的Release功能主要用来对仓库中的代码以及其他一些相关资料文件进行归档，通常用于版本发布。当有新版本发布时，用户可以基于对应的Commit创建一个Tag标记，给它一个合理的名字，比如“v1.0-pre”（代表发布1.0预览版），然后再基于该Tag发布版本。后期，其他人可以通过Release菜单快速浏览、检索项目版本发布记录以及对应时间点的相关代码和资料。用户可以在Gitlab主界面的左侧菜单中找到Release功能入口：
Gitlab中Release菜单 |
上面图片在介绍Release功能时给出的图片中包含的菜单项太多，为了让读者更直观看懂图片关注点，可以将图片调整如下（左右两种都可以）：
|
√ |
|
Gitlab中的Release功能主要用来对仓库中的代码以及其他一些相关资料文件进行归档，通常用于版本发布。当有新版本发布时，用户可以基于对应的Commit创建一个Tag标记，给它一个合理的名字，比如“v1.0-pre”（代表发布1.0预览版），然后再基于该Tag发布版本。后期，其他人可以通过Release菜单快速浏览、检索项目版本发布记录以及对应时间点的相关代码和资料。用户可以在Gitlab主界面的左侧菜单中找到Release功能入口：
Gitlab中Release菜单 |
有准确的图标题
图片是为了读者能够更直观地理解文档内容，但是图片毕竟不是文字，不同的人对同一张图片的理解可能存在差异，尤其对于那种不包含任何文字的图片。因此，在文档中插入任何图片时，我们应该为它定义一个合适、贴切的标题。图标题一般是一个名词或者短语，作用跟前面讲到的标题一样，协助读者理解图片所要表达的含义。