当主流笔记软件纷纷接入大模型、推出智能写作与知识库功能时，一个更基础的问题正被反复暴露：无论 AI 生成多快，一旦内容落入现有编辑器框架，格式错乱、位置偏移、结构崩坏仍屡见不鲜。这背后并非算力不足，而是编辑器底层对 Markdown 的处理逻辑存在系统性缺陷。 近期，一款名为 MSFE（Markdown Source-First Editor）的开源框架引起开发者关注。该项目由一位拥有三年 ProseMirror 开发经验的工程师主导，目标明确：不急于做应用层产品，而是先厘清并重建 Markdown 编辑器的底层范式。 ### 三类主流方案及其固有局限 根据截至 2026 年 10 月的公开资料梳理，当前主流笔记与编辑器产品在技术实现上可归纳为三大路径：  第一类是**块编辑/富文本派**，包括 Notion、飞书文档、思源笔记、AFFiNE 与 AppFlowy。它们以块（block）为基本单元构建文档树，编辑时操作的是结构化节点数据；Markdown 仅作为导入导出的中间格式存在。这类方案体验流畅，接近传统文档工具，但代价是原始 Markdown 源码无法保全——用户输入的 `# 标题` 可能被转为 `

标题

`，再导出时又变成 `## 标题`，符号层级悄然改变。 第二类是**源码派**，代表如 Obsidian、Logseq 与妙言 MiaoYan。它们始终以纯 Markdown 文本为唯一真相源，编辑即修改 `.md` 文件本身。优点是源码零损耗、版本控制友好；缺点在于界面交互受限，即便加入实时预览，仍难摆脱“语法符号可见”的原始感，离所见即所得尚有距离。 第三类则是**双模式切换派**，如 MarkText、NoteGen、Flowix 与 Joplin。它们同时维护一套富文本渲染视图与一套源码视图，切换时需执行文档树与 Markdown 之间的双向转换。问题在于：每次切换或保存，都是一次潜在的数据变形过程。例如，Tiptap 或 TinyMCE 构建的文档树，在转回 Markdown 时可能将嵌套列表扁平化，或将自定义 HTML 标签忽略，导致用户“写完就变样”。 ### 核心矛盾：转换规则不可协商 上述分歧的本质，在于对“什么是文档真相”的理解不同。富文本派认为结构才是核心，Markdown 是一种序列化表达；源码派则坚持文本即真理，任何中间表示都是临时投影。 而现实困境是：**转换只能按预设规则进行，用户的原始意图无法被完整保留**。例如，用户手写 `> [!NOTE] 这是一个提示框`，若编辑器未内置对应块类型解析器，该行可能被当作普通引用块处理，后续导出时变成 `> 这是一个提示框`，语义信息永久丢失。再如协同编辑场景下，多个用户同时修改同一段落，若底层采用 Yjs 或 yrs 等 CRDT 协议同步的是块树而非文本流，合并时极易产生结构错位——一个用户插入的代码块被误拆成两段，另一用户添加的注释被吞掉。 AI 生成内容加剧了这一问题。大模型输出常含非标准语法（如自定义标签、嵌套表格、复杂数学公式），现有编辑器缺乏弹性解析能力，要么报错，要么强行“规范化”，结果就是用户看到的与模型生成的不一致。 ### MSFE 的解法：从源码出发，插件化扩展 MSFE 提出的路径是“源码优先”（Source-First）：所有编辑操作直接作用于 Markdown 原文，不引入独立的文档树抽象层；渲染与交互通过插件动态注入，而非硬编码进内核。 其架构分为三层： 1. **源码层**：纯文本编辑器，使用 CodeMirror 6 实现高性能高亮与光标定位； 2. **插件层**：提供可插拔的功能模块，如 `StarterKit`（基础语法支持）、`Mermaid`（图表渲染）、`Math`（LaTeX 公式）等； 3. **呈现层**：由插件决定如何渲染特定语法节点，例如 `> [!TIP]` 可由 `AdmonitionPlugin` 解析为带图标卡片，而不改变原文结构。 这种设计确保了三点：  - 用户始终面对原始 Markdown，无“转换损耗”； - 新增语法支持只需新增插件，无需改动核心； - 协同编辑可在文本粒度上实现 CRDT 同步（如基于 Operational Transformation 的文本 diff），避免结构级冲突。 项目已开源，演示站点 msfe.quirekit.com 提供在线体验。从界面看，它支持经典分页文档、块编辑视图、实时预览与源码模式切换，但所有模式共享同一份文本状态——这是与双模式方案的根本区别。 ### 行业意义：回归编辑器本质 MSFE 的出现，并非否定富文本交互的价值，而是指出：在追求“智能”之前，应先夯实“准确”与“可控”的基础。尤其对于开发者、技术写作者与科研人员而言，文档的精确性远高于界面美观度。 值得注意的是，该框架并未排斥 AI 集成。相反，因其源码一致性，AI 辅助功能（如自动补全、语法纠错、结构优化）可更可靠地作用于原始文本，减少“生成—粘贴—变形”的链路损耗。已有团队尝试将其接入本地 LLM 工作流，用于技术文档自动化润色。 对比同类开源项目，MSFE 与 ProseMirror 路线形成互补：前者强在结构化协作，后者重在文本保真。二者并非替代关系，而是在不同需求场景下的技术分叉。 目前，MSFE 仍处于早期阶段，插件生态尚不完善，对复杂表格、多级嵌套列表的支持有待加强。但其理念已引发讨论——在 AI 编辑器军备竞赛之外，是否需要一场“底层静默革命”？ 编辑器的终极目标不是让用户感觉“像在写 Word”，而是让每一次输入都被忠实记录、每一次修改都可追溯还原。MSFE 正在为此提供一种可行的技术路径。