出品 | 开源中国

其实最早的计算机技术文档可以追溯到 1944 年，美国哈佛大学 Mark 1 ASCC 自动序列控制计算机研发小组成员 Grace Hopper 为他们研发的这台早期计算机撰写了操作手册。

还有另一个说法称“世界上第一本电子计算机手册”是 BIAC 二进制自动计算机的操作和维护手册，由 Joseph Chapline 于 1949 年编写。该手册创建了一系列计算机手册标准，并成为后来诞生的许多其他计算机手册的模板。

尽管这两个案例可以追溯到 1940 年代，但直到 1960 年代后期，随着面向过程的编程语言在第三代微型集成电路计算机中的使用，才使得代码注释和技术文档成为软件开发的标配。

也是从这一时期开始，为了统一文本在不同计算机软硬件上的格式标准，GML、TEX、LaTex、HTML、Markdown 等标记语言相继面世，这些标记语言将计算机中的文本以及文本相关的其他信息结合起来，展现出关于文档结构和数据处理细节的计算机文字编码，为计算机文本的格式制定了标准。这些标记语言也成为不同时期软件工程师们撰写开发文档时必备的技能。

其中，Markdown 作为最年轻的标记语言到被广泛沿用至今，成为很多习惯纯键盘操作的开发者们用于技术写作的不二之选。

为什么开发者喜欢 Markdown？

▲ John Gruber

受到纯文本电子邮件通信美学的启发，在 Reddit 联合创始人 Aaron Swartz 的协助下，John Gruber 于 2004 年 3 月 19 日推出了第一个版本的 Markdown。

Markdown 相比 HTML 等富文本格式更加轻便，只包含分级标题、字体加粗、斜体、引用、添加代码块、插入图片/超链等程序员群体常用的文档功能，且格式非常简单，可以实现排版+写作同时进行，且无需使用鼠标点选调整格式，非常适合习惯了纯键盘操作的程序员们。

另一方面，Markdown 简洁的语法非常容易被浏览器解析，这使得 Markdown 几乎适用于任何 Web 场景，这也是其日后被广泛用于代码托管平台 Readme、开源项目在线文档、开发者个人博客等场景的重要原因之一。

得益于这些专为技术文档而生的优秀特性，Markdown 很快在开发者群体中流行开来。

始于 Markdown 的语雀

目前，除了自建博客外，各类支持 Markdown 的写作平台已经成为了国内开发者首选的文档和知识库建立工具，例如 Notion、语雀、石墨文档、印象笔记等。

其中，语雀作为蚂蚁集团内部孵化的项目，在开发者 区中收获了不俗的口碑。据统计，在语雀最受欢迎的文档插入功能卡片中，使用量排行第一的是图片卡片，现在已经有 7100 万个，而使用量排行第二的就是代码块，达到 2500 万个，可见开发者群体在语雀用户中的占比之大。

阎王 —— 这位花名霸气的技术小哥在写作方面的经历与开源中国的很多技术博主类似，除了是语雀研发团队的一名开发者外，业余时间也是一个技术自媒体，用“小胡子哥”这个笔名写了十多年的技术博客。

“小胡子哥”最初在博客园上做内容分享，后来又购买云服务器自建博客，也曾将博客整体迁移到 GitHub 上，兜兜转转在 2016 年首次接触到了语雀，成为了语雀的早期用户。

阎王介绍，自己日常的写作会有三种状态：

首先是语雀的代码块功能。早期的语雀只是简单的 Markdown 代码块渲染。经过迭代，语雀代码块在样式和支持的语言上都进行了加强，支持近百种常见的编程语言样式；此外还增加了代码块的命名、主题切换、高度调整、函数折叠等功能，能够满足绝大多数代码展示的需要。

语雀的画板功能也非常好用，不仅支持文本绘图，还结合了思维导图和流程图，提供非常丰富的绘图元素，提供了快速制作技术架构图的能力。

利用语雀的开放接口，开发者可以把语雀上的博客同步推送到 GitHub 的个人仓库：

写作对于每一个开发者来说都是非常好的习惯，能够帮助我们实现终身学习的目标，而一款好用的文档工具能够帮助我们将所学所想建立成知识库，并受益终生。

“在程序员的日常里，不仅我们的代码高并发地跑在机器上，脑子也是一样的，每天我们都要处理非常非常多的事务，处理不过来怎么办呢？这个时候就需要有一个信息的中转站，控制一下信息流转的速度，同时呢，在这个中转站里面，把无效信息给剔除掉，然后分门别类地做好归类，最后再交给大脑处理，这样才能游刃有余地把事情一件一件做好。这个理念在语雀里也有很好的体现。”