经济学讲通货膨胀,为什么你写的文档也会「标题泛滥、重点贬值」

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:虽然公众号没有可点击的目录,但读者在滑动屏幕时,加粗的标题就是他们的「视觉锚点」。

让信息更容易被看见、理解、记住和行动,从一个好的标题层级开始。

以上就是本期的全部内容,我们下期见🦩🦩🦩

相关推荐
深念Y2 小时前
视频平台架构重构:从微服务到云原生
服务器·微服务·云原生·重构·架构·音视频·短视频
国医中兴10 小时前
电子病历的时序数据分析:ClickHouse在临床指标监控中的落地
微服务·云原生·容器·kubernetes·k8s
亚历克斯神11 小时前
低代码与 AI 的融合趋势——从可视化搭建到自然语言生成应用
java·spring·微服务
leonkay13 小时前
C# 特性(Attribute)——【2】工业设备参数框架设计
经验分享·面试·架构·c#·学习方法·设计
知了一笑17 小时前
订单的含金量在分化
产品·订单业务
怕浪猫18 小时前
用好这 5 把钥匙,你就能拦截 AI Agent 的一切行为
数据分析·agent·产品
qq_5896660519 小时前
Java微服务介绍及应用
java·开发语言·微服务
易番番ERP21 小时前
筹备ERP项目|前期认知与调研的核心要点
微服务·云原生·易番番erp
星期一研究室1 天前
听说你的文档比同事好看十倍
微服务·产品·设计