浏览器里直接编辑 Word 文档,这个开源项目做到了

Word 文档（.docx）大概是职场人最离不开、又最让人头疼的格式。

传过来传过去，格式乱成一团；想在网页里展示个文档，要么转 PDF 丢质感，要么用在线编辑器丢格式。

有没有一种方案，能让用户在浏览器里直接打开、编辑真实的 .docx 文件，编辑完直接保存，不用任何 Office 软件？

SuperDoc 就是来解决这个问题的。

什么是 SuperDoc？

SuperDoc 是一个开源的「DOCX 文档引擎」，它的核心能力是：在浏览器里直接解析和渲染真实的 .docx 文件格式。

不是那种把 Word 文档转成 HTML 的权宜之计，也不是用 contenteditable 模拟的富文本编辑器，而是真正基于 OOXML 标准解析 .docx——分页、页眉页脚、目录、脚注尾注，都能完整保留。

核心功能

1. 真实格式保真

SuperDoc 基于 OOXML 标准构建，解析的是真实的 Word 文档格式。这意味着：

• 分页符、章节分隔符完整保留
• 页眉页脚与 Word 桌面端一致
• 目录、脚注、尾注都能正确显示

2. 主流框架全覆盖

一行命令即可集成到你的项目：

bash
# React npm install @superdoc-dev/react # Vue  npm install @superdoc-dev/vue # 原生 JS npm install superdoc

支持 React、Vue、Angular、Svelte，以及原生 JavaScript，几乎没有学习成本。

3. 多人实时协作

内置 Yjs CRDT 协程技术，支持：

• 多人同时编辑同一个文档
• 评论功能
• 修订模式（Track Changes）
• 自动冲突解决

4. AI 文档自动化

SuperDoc 支持让 AI 帮你处理文档：

• AI 自动批注和修订建议
• 无头模式（Headless）运行，适合服务器端批量处理
• 模板自动化填充
• 文档对比和红框标注

5. AI 编程助手集成

官方提供了 MCP 服务器配置，让 AI 助手能直接「操控」Word 文档：

bash
npx @superdoc-dev/create # 为项目生成 AI 配置 claude mcp add superdoc # 连接 Claude 到 DOCX 文件

技术架构

SuperDoc 的技术栈选择非常务实：

• 编辑器内核：基于 ProseMirror，这是目前最成熟的富文本编辑器框架之一
• 实时协作：基于 Yjs，CRDT 算法保证了协作的数学正确性
• 文档格式：使用 JSZip 解析 OOXML，绕过了微软的私有格式
• 构建工具：Vite，开发体验和构建速度都有保障

使用场景

适合的场景：

• 企业内部文档系统，需要保真展示 Word 格式
• 多人协作编辑平台，天然支持实时协作
• AI 文档处理流水线，比如自动填写模板、批量生成报告
• 文档自动化处理，服务端批量转换格式

不太适合的场景：

• 只需要简单富文本编辑（Quill、Tiptap 更轻量）
• 需要完整 Office 功能（宏、VBA 等）

总结

SuperDoc 填补了一个长期存在的空白：在浏览器里完美编辑真实的 .docx 文件。

它不是要做成一个「网页版 Word」，而是做文档的「解析和渲染引擎」——这个定位很清晰，也很务实。

如果你正在做内部文档系统、协作平台，或者需要让 AI 处理 Word 文档，SuperDoc 值得关注。

GitHub：https://github.com/superdoc-dev/superdoc

官网：https://www.superdoc.dev

文档：https://docs.superdoc.dev