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
夜雨聆风