5.1 编辑器：按场景选型

5.1 编辑器：按场景选型

Markdown 编辑器分三大类：所见即所得型、双栏预览型、工程型（通用编辑器加插件）。没有最好的编辑器，只有和你的写作场景匹配的编辑器——这节给出选型框架和几条踩过坑后的经验。

三类编辑器的体验差异

所见即所得型（代表：Typora、各类笔记应用）：敲下井号回车，标题样式直接呈现，没有"源码态"。适合散文式写作——注意力始终在内容上。代价是：你不看见源码，对语法细节的手感会变钝，偶尔插入奇怪字符不易察觉。

双栏预览型（各类在线编辑器、简易桌面编辑器）：左边源码右边渲染，实时同步。适合学语法阶段（本教程就假设你用这类），也适合写"语法密度高"的文档——源码与效果对照，错误无所遁形。

工程型（通用代码编辑器加插件）：写代码的人顺手写文档的选择。版本控制集成、多文件工程、快捷键自定义全都在，但预览体验靠插件，开箱体验不如前两类精致。

选型框架：先问三个问题

1. 文档给谁看？ 个人笔记优先体验（所见即所得足够）；对外发布的文档优先可控性（双栏或工程型，看得见源码才放心）。
2. 写作嵌在什么工作流里？ 和代码同仓的文档，工程型编辑器几乎是唯一答案；独立的专栏写作，体验优先。
3. 团队协作吗？ 协作文档统一编辑器很重要——不同编辑器的自动格式化规则不同，混用会产生无意义的 diff 噪音（详见第 6 章规范）。

💡 关键直觉：编辑器是"租"来的，源文件是"自己的"。任何时候把文档导出为纯文本能在别处正常打开，你就没被工具绑架。定期检查你的笔记应用是否支持无锁定地导出标准 Markdown 文件，不支持的工具存重要内容要三思。

值得养成的编辑器习惯

无论用哪类，这几个习惯回报率极高：

• 学会表格格式化快捷键/命令：一键对齐管道符，源码可读性翻倍（2.1 节提过）。
• 配置粘贴自动转义：从网页复制文本常带智能引号和特殊空格，自动清理能防一类诡异渲染问题。
• 开启保存时格式化并全团队统一配置：格式差异不再进 diff。
• 大文档拆文件：单文件超过几千行就按章拆分，编辑器性能和协作合并都会感谢你。

从需求到工具类型的映射

把"团队统一配置"落成文件

"全团队统一配置"不该停留在口头约定，工程型编辑器环境下它可以完全文件化并随仓库走。以最常见的格式化方案为例，一份十几行的配置放进仓库根目录，任何人任何编辑器打开同一份文档，保存后的格式完全一致：

{
  "proseWrap": "preserve",
  "singleQuote": true,
  "trailingComma": "none"
}
​

# 首次接入：仓库根目录装好依赖后一键格式化全库
npx prettier --write "docs/**/*.md"
# 日常校验（可挂进 CI，未格式化的提交直接打回）
npx prettier --check "docs/**/*.md"
​

第一段配置里 proseWrap: preserve 是关键一条——禁止格式化器自动折行中文正文，否则每次格式化都产生大量无意义断行 diff，这也是团队引入自动格式化最常见的翻车点。第二段的两条命令构成完整闭环：接入时全量格式化一次，之后 CI 用检查模式守门，格式 diff 从此在合入前被拦截。双栏与所见即所得编辑器没有这样标准的配置文件，退而求其次的做法是把格式化规则写成一份手动检查单（换行、列表标记符、表格式对齐三件事），评审时照单过——工具可以不同，产物规范必须相同，这是编辑器选型自由的边界。

本节要点回顾

• 三类编辑器对应三类场景：体验、对照、工程；按"给谁看/什么流/是否协作"三问选型。
• 源文件是资产，工具可替换，定期验证无锁定导出。
• 统一团队的格式化配置，杜绝格式 diff 噪音。
• 好习惯四件：表格格式化、粘贴清理、保存即格式化、大文档拆文件。

选型之外：让工具链可替换的三个验证动作

选好编辑器只是起点，工具链的长期健康靠定期验证"没被锁死"。第一个验证动作是季度导出演习：把笔记库完整导出为纯 Markdown 目录（含附件），检查双链、标注、附件引用是否都有可读的降级形态——Obsidian 的"导出为标准 Markdown"、Notion 的批量导出都值得每季度真跑一次而不是"知道能跑"。第二个是格式化器独立于编辑器：格式化配置（prettier 的 markdown 支持是主流选择）放进仓库而不是编辑器全局设置，换编辑器、上 CI 都能复用同一份格式。第三个是附件按文件夹管理：图片等附件始终落在文档同级的相对路径目录里，而非工具私有数据库——附件是最容易被平台绑架的资产，路径自理是唯一保险。三个动作加起来一年耗时不过两小时，却决定了五年后你的笔记还是你的。

编辑器技巧的迁移成本核算

换编辑器真正贵的不是重新学界面，而是肌肉记忆与插件的迁移成本，选型时应把"可迁移技巧占比"当作隐性指标。值得刻意投资的都是可迁移技巧：Markdown 语法本身的熟练（任何编辑器通用）、正则批量替换（处理旧文档的万能工具，VS Code、Obsidian、命令行同语法）、表格源码对齐的眼力。反之，深度绑定单一编辑器的花哨功能要看清再投入——那些无法带走的技巧，换工具时全部清零。一个实用的自检：每年评估一次"如果明天换工具，我的写作效率会掉几成"，掉三成以内说明投资健康，掉一半以上就该把精力挪回可迁移技能。

团队工具链统一的现实路径

个人选型自由，团队协作却需要最低限度统一，现实路径是只统一交换格式与格式化器，不统一编辑器。具体三条：仓库内所有 Markdown 以 UTF-8 无 BOM、LF 换行存储（.gitattributes 一行搞定）；格式化统一跑 prettier 的同一份配置（随仓库走）；预览效果的争议以"目标平台渲染"为准绳而非各自编辑器。做到这三条，用 Typora 的和用 Vim 的可以无感协作，diff 干净、渲染一致。反过来强推统一编辑器几乎必然失败——工具偏好是个人肌肉记忆，统一它得罪所有人，而统一交换格式谁也不得罪，收益却拿到了九成。