第5章 工具链与生态

第5章 工具链与生态

章节摘要：写作的另一半世界是工具。编辑器决定你的书写体验，解析器决定文档最终长什么样，转换器决定稿子能去哪些格式。本章把三类工具的选型逻辑讲清楚——不是罗列产品名，而是给你一套"按需求挑工具"的判断方法，并串起从动笔到发布的完整链路。

学习目标

阅读完本章，你应当能够：

1. 按自己的使用场景（笔记/长文/工程文档）选定合适的编辑器类型。
2. 理解"解析器实现决定渲染结果"，会查目标平台用的是哪个解析器。
3. 用转换工具把一份 Markdown 源稿输出为网页、文档、幻灯片等格式。
4. 串起"编辑 → 预览 → 转换 → 发布"的完整工作流。

核心概念速览

源文件是你唯一的资产，编辑器和解析器都可以换——所以一切工具决策都要守住"源文件干净、不被工具私有格式绑架"的底线。

子章节导航

5.1 编辑器：按场景选型

所见即所得、双栏预览、工程型编辑器三类体验的利弊。

5.2 渲染器与解析器：方言的执行者

同一个解析器的不同配置，足以让你的文档换一副面孔。

5.3 格式转换与发布链路

从一份源稿到多格式输出的完整管线，以及发布前的检查动作。

子章节之间的逻辑关系

三节对应文档生命周期的三段：

写作段（5.1 编辑器）
   → 渲染段（5.2 解析器，决定读者看到什么）
      → 输出段（5.3 转换与发布，决定稿子能去哪里）
​

工具可以简单也可以复杂，但三段缺一不可——哪怕三段都由同一个平台代办，理解分工也能帮你定位问题出在哪一环。

前置知识与后续延伸

• 前置：第 4 章的方言知识——解析器选型本质上是方言选型。
• 为后续铺垫：第 6 章的团队规范（编辑器统一、转换管线入自动化）在实践层面落地本章内容。

三段定位法：出问题先问在哪一环

本章三节合起来给了一条最有用的排障思维：任何"文档不对了"，先定位发生在哪一段。写作段的问题特征是"源文件就错了"——错字、格式记号笔误，换任何工具打开都错，责任在人与编辑器；渲染段的问题特征是"源文件对、显示不对"——本地正常平台异常，或换个环境就变形，责任在解析器配置；输出段的问题特征是"在线版好好的、导出的格式不对"——图丢、路径断、层级乱，责任在转换管线。三段的处置动作完全不同：写作段改稿、渲染段查配置或换写法、输出段补转换前处理。定位错段落，就会在正确的稿子上空查一下午解析器配置——这是工具链问题里最常见的时间黑洞。养成先问"在哪一环"的习惯，本章的工具知识才能真正变现为排障效率。

再补一个把三节工具知识兑换成日常效率的小动作：为你的主力工具组合写一张"启动卡"——编辑器、格式化命令、预览方式、发布命令各一行，贴在显眼处或存成桌面便签。工具链的隐性成本从来不是学习，而是每次"隔了几周再拿起时想不起入口"。启动卡把回忆成本压到零，新同事入职时这张卡也是最好的工具链说明书，一举两得。

最后给一个把本章三节压进日常的操作建议：在团队 wiki 建一页"工具链登记表"，列出当前选定的编辑器、格式化配置位置、渲染器及其扩展开关、发布管线入口。工具链的任何变更在这页登记一行（日期、变更、原因）。半年后回看这页表，工具演进脉络与每次变更的依据都在——工具链从"大家各自的习惯"变成"有账可查的系统"，本章的全部知识在这页表里落了地。

这条登记表还有一个衍生用法：入职引导。新同事的第一周让他通读登记表并复现其中三个条目，比任何口头介绍都更快建立对团队工具链的实感——工具链知识从"散落在各人脑中"变成"登记表上一行行可验证的事实"，这正是本章希望达成的状态。