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虽然公众号没有可点击的目录但读者在滑动屏幕时加粗的标题就是他们的「视觉锚点」。让信息更容易被看见、理解、记住和行动从一个好的标题层级开始。以上就是本期的全部内容我们下期见