从一条笔记到一篇长文：整理、写作与回看

笔记不必从完整的结论开始。有时候，它只是读到一句话时留下的疑问，或一次实践后还没有解释清楚的现象。将这些零散记录写成文章，需要的不是一次性想清楚所有问题，而是逐步建立可供自己和别人理解的顺序。

这篇示例把一次写作过程分成几个阶段。你可以顺着正文阅读，也可以使用侧栏目录直接跳到某个小节；图表、引用、代码和脚注都属于同一份文档。

一、先保存问题

最早的记录通常很短：发生了什么，我原本期待什么，以及哪些地方让我困惑。此时不急着给问题起一个宏大的名字，先保留足够具体的背景。比如“页面加载有点慢”很难复查，而“在手机网络下打开有十张图片的文章，首屏等待明显增加”就给下一次观察留下了入口。

记录背景时，也要区分亲眼看到的情况与自己的推测。前者可以成为讨论的共同起点，后者需要进一步验证。把两者写在相邻但独立的句子里，日后回看时就不容易把当时的猜想误认成结论。

二、给材料一个暂时的位置

材料可以按问题、时间或来源组织。分类的目的不是建立永远正确的体系，而是让下一次需要它时能够找到。一个暂时叫作“待整理”的目录并不意味着失败，只要其中每条记录仍然带着来源和写下它的原因。

同一条材料也可能服务不同问题。与其反复复制内容，不如保留原始记录，再用链接说明它与当前文章的关系。这样，当原始信息被修正时，读者仍有机会回到来源，而不是面对几个已经互不一致的副本。

• 原始记录保留发生时间与上下文。
• 摘录标明来源，自己的评论另起一段。
• 尚未验证的判断留下具体的验证方式。

三、确定文章要回答的问题

读者不一定与作者拥有相同的背景。开头需要说明这篇文章讨论什么，以及读完之后能得到怎样的认识。范围可以小，但要明确；一篇回答清楚一个问题的文章，比同时触及十个问题却没有展开更容易被使用。

写作过程中出现新的方向是正常的。可以先记到旁边，等当前问题的解释完成后，再判断它适合成为补充说明、后续文章，还是应该删除的岔路。保留材料和保留在正文里，是两件不同的事情。

写作中的取舍，不是在判断一个想法有没有价值，而是在判断它是否帮助当前这段说明继续向前。

四、让段落承担明确的工作

每段可以有一个主要任务：提出问题、描述现象、给出证据、解释原因，或说明限制。任务清楚时，段落之间的连接也更容易检查。如果连续几段都在重复同一个判断，可能需要补充证据，而不是再换一种说法。

句子长短可以变化，但重要信息不宜全部挤在同一句中。写到包含多个转折的长句时，试着按意思拆开，观察每个部分是否仍然必要。中文与 English 术语混排时，也应先保证概念被解释清楚，而不是依赖读者自行猜测缩写。

五、用表格做真正的比较

表格适合让读者横向比较几个稳定的维度。如果每个单元格都需要一大段独立论述，普通小节可能更合适。下面的表格只是一个写作过程记录，不意味着每次写作都必须经过完全相同的步骤。

在窄屏上，表格可以在自身区域内横向滚动。正文不应该为了放下表格而把整个页面撑宽，也不应该把每一列压成难以阅读的竖排文字。

六、示例应当能够独立理解

代码示例需要保留必要的输入与输出。只给出中间一行，可能对已经熟悉问题的人足够，却会让第一次接触的人不知道该从哪里开始。示例可以简短，但删减之后仍应能说明作者声称的行为。

const notes = [
  { title: "一次观察", reviewed: true },
  { title: "一个待验证的问题", reviewed: false }
];

const pending = notes.filter(note => !note.reviewed);
console.log(pending.map(note => note.title));

这里的代码只是把尚未回看的记录筛选出来。它不承担整个笔记系统的设计，也不需要为这个简单说明引入额外框架。读者可以复制它，再根据自己的材料尝试修改。

七、引用与脚注各有用途

引用应当帮助读者理解当前讨论，而不是代替作者解释。引用之后，仍需要指出它与文章问题的关系。对于不适合打断正文的补充，可以放在脚注中，让有需要的读者继续查看。^[1]

脚注也不能成为堆放所有不确定信息的地方。如果某个限制会改变整篇文章的结论，它应该出现在正文中；如果只是术语来源或一个延伸入口，放在脚注里就比较合适。

八、图片需要说明它在解释什么

图片可以帮助读者看见文字难以描述的关系，但它也需要上下文。放入一张图片之前，可以问自己：读者应当从中注意什么？它与前一段、后一段分别是什么关系？如果移除图片后文章仍然完整，它也许只是气氛；这没有问题，但不应让它阻碍正文。

替代文字和图片说明面向不同的阅读情况。替代文字帮助无法看到图片的读者了解内容；说明可以进一步交代图片来源、观察重点或补充背景。两者不必机械地重复。

九、为不同阅读方式留出空间

有人从头读到尾，有人先查看目录，有人通过搜索结果来到文章中间。清晰的标题和稳定的锚点让这些路径都能成立。链接应当描述目的地，折叠内容则适合不影响主线的补充，不适合隐藏理解结论所必需的前提。

十、发布之后继续修订

文章发布并不意味着问题永远得到解决。新的材料、读者的反馈和作者自己的实践，都可能带来修订。重要的是让修改有迹可循：实质性的变化可以更新日期，并在适当位置说明哪些结论发生了改变。

回看旧文章时，不必把过去不够成熟的表达全部抹去。可以保留有价值的观察，补上当时不知道的限制，再把已经失效的步骤明确标记出来。这样的文章既是给读者的说明，也是作者思考过程的一部分。

如果你正在检查主题，可以继续访问 无摘要文章、长标题边界 或返回 示例入口。