01 前言
今天聊一个长文档很容易犯的问题:标题层级的通胀。
跟经济学里的通货膨胀很像:钱印多了,每一张的购买力就下降了。标题也是一样,层级用多了,每一层的「导航力」就被稀释了。
读者的注意力是有限的,当所有东西都在喊「我很重要」的时候,就等于没有东西重要。
所以这一期,我们就来拆解:标题层级到底怎么用,才能让文档的结构真正帮到读者。
02 典型翻车现场
我们先来看几个典型问题。
(1)层级过深
第一个案例,标题从 H1 一路往下钻,H2、H3、H4、H5......像一个无底洞,越挖越深。

(2)层级平行
文档有三个独立的部分,但在目录里,它们挤在同一个层级上,无法区分。

(3)层级混乱
标题层级混乱,看不出规律。
当层级随机跳动的时候,读者建立不起阅读预期:「下一个标题跟前面那个是什么关系?」

以上的问题在于:标题层级没有为读者建立导航,反而在制造困惑。
- 层级太深,读者迷失在纵深里;
- 层级太平,读者分不清主次在哪里;
- 层级太乱,读者连方向感都没有。
那搞清楚了问题出在哪,接下来我们聊聊怎么改。
03 四种方法论◎随你挑选
这里我们以飞书文档作为对象,来进行接受。
(1)层级克制法
在飞书文档中,预置了1~ 9 级 的标题,一般来说,一级的字体最大 ,九级的字体最小。
那在平常的文章撰写中,一般是从一级 开始使用,最多用到四级,也就是4个层次。
为什么只用4种级别呢,因为在网页的 SEO 中,它会按照 H1、H2、H3、H4...... 这个顺序,依次去抓取整篇文章的关键词。层级越小,在 SEO 的排序就越靠前。
还有另外一个点是,使用4个层级对整篇文章的阅读来说,「心智负担」刚刚好。当读者读到第三层的时候,想着再读下第四层,马上就读完了。而如果写了六七层,读者读到第4层的时候,内心可能想着:怎么这个小标题后面还有这么多内容啊😭
不过在极个别情况下,有可能一个小标题下面就是会有很多衍生的东西。那这个时候就可以考虑:合并内容,拆分层级。比如这样:


(2)标题剧透法
有些标题的问题在于,它们只告诉你「这段叫什么」,但没有告诉你「这段讲什么」。
简单来说,一个好标题应该像一句剧透:读者扫一眼目录,就能直接明白这个段落要讲什么,把里面的核心内容透露出来。
来看一个真实的改前改后对比👇🏻:


目录从模糊的功能名变成了「一、参考文章」「二、产品形态」「三、功能详细剖析」。
那怎么判断一个标题够不够直观呢?测试方法是:只看标题,你能猜出正文是什么吗? 如果猜不出来,说明标题和内容之间没有建立关联,它就是一个「空壳标题」。
(3)平行命名法
你会发现,有些文档的目录一看就很「整齐」,哪怕内容你还没读,光看标题就觉得舒服。而有些目录明明却总觉得哪里别扭。
这个差异来自于:同级标题的语法结构是不是平行的。
比如你有三个并列的小标题,它们应该遵循同一种语法模式:
- 全是名词短语:「插件功能 / 浮窗功能 / 网站功能」
- 全是动宾结构:「安装插件 / 配置浮窗 / 部署网站」
- 全是句子形式:「人工智能是什么?/ 带你了解人工智能的纸短情长 / 如何使用人工智能?」
但如果混着来:「插件功能 / 怎么配置浮窗 / 网站」,读者的眼睛扫过目录时就会「卡」一下。
简单来说,平行命名的核心就是:同一层的标题,用同一种句式说话。这样读者在扫描目录的时候,逻辑是丝滑衔接的。
除了语法结构要平行之外,同级标题的文字长度 也有讲究。一般遵循三种规律:①从多到少;②从少到多;③不相上下。
来看几个小案例👇🏻:



(4)标明序号法
在分完层级之后,还要做的一件事情是尽量给各个层级增加序号。
为什么这里会谈到序号呢?
我们可以发现,我们在看书或者看一些知识合辑的时候,上面的序号都会标注得很明确。然后我们读到某一章的时候,就只需要记住读到哪一章哪一节,心里就形成了一个标记。
后来周一在写技术文章的时候,也实践了一番。如果文章很长,但是我没有做序号,看起来会总觉得有点不知头尾。但是做了序号的文章,心里就会形成一种秩序感,同时也让我们快速定位到想要找的文件在哪里。
虽说这一步很繁琐,但是这个时间跟后续的阅读体验相比,就会觉得这一步的行动是值得的。
下面来看一些小案例:


04 适用于什么场景?
上面聊的四种方法,并不只适用于某一种工具。只要你在写「有标题层级的长内容」,它们就能派上用场。
- Markdown 文档 :技术博客、GitHub README、个人知识库。虽然Markdown 本身只有
#到######六级标题,层级克制法在这里也同样重要,用到四级就该考虑拆分内容了。 - 飞书 / Notion / 钉钉 等在线文档:团队协作场景下,一篇文档往往有多个人参与编辑。如果标题层级没有统一规范,时间一长就会变成「随机层级」翻车现场。
- 技术文档 / API 文档:技术文档适合先看目录定位,再跳到目标段落,所以「标题剧透法」在这里价值最大。
- 公众号长文 / Newsletter:虽然公众号没有可点击的目录,但读者在滑动屏幕时,加粗的标题就是他们的「视觉锚点」。
让信息更容易被看见、理解、记住和行动,从一个好的标题层级开始。
以上就是本期的全部内容,我们下期见🦩🦩🦩