Docmost 文档导入：4 种格式完整指南，知识库搬家不用手动复制
【免费下载链接】docmostDocmost is an open-source collaborative wiki and documentation software. It is an open-source alternative to Confluence and Notion.项目地址: https://gitcode.com/GitHub_Trending/do/docmost
Docmost 是开源的协作文档平台。它的文档导入支持 Markdown、HTML、通用 ZIP 和 Notion、Confluence 导出包，帮你把散在各处的知识库一次性搬完。
文档导入方式对比：4 种格式怎么选
先给结论，按你的现状对号入座：
| 格式 | 适合谁 | 步骤量 | 注意点 |
|---|---|---|---|
| Markdown / HTML 单文件 | 一两篇独立文档 | 选文件、上传，秒级完成 | 文件用 UTF-8，别超单文件大小上限 |
| 通用 ZIP 包 | 自维护的 docs 目录，做 Markdown 批量导入 | 打包后一次上传 | 文件夹层级就是页面层级，图片用相对路径 |
| Notion 导出包 | 从 Notion 迁出的人 | Notion 官方导出 + 一次上传 | 用 Markdown & CSV 格式导出 |
| Confluence 导出包 | 做 Confluence 文档迁移（企业版） | Confluence 官方导出 + 一次上传 | 需要企业版（EE）授权 |
Notion 导出包导入步骤：从导出到完成
📦 这条线走的人最多，下面拆成 5 步。
1. 从 Notion 导出 Markdown 压缩包
在 Notion 里打开设置，进导出：范围选"整个工作区"或目标页面，格式选 Markdown & CSV。导出的 zip 里，每个页面是一个 .md 文件，文件名尾部带一长串 ID，子页面放在同名子文件夹里。数据库会被导成 CSV，不影响正文导入，可以先不管。
2. 快速检查包内容
上传前花十秒钟看一眼结构，确认没有导错范围：
unzip -l notion-export.zip | head -30确认页面文件按目录铺开后，就可以直接上传。
3. 在 Docmost 中上传 Notion 导出包
进入目标空间，在页面列表上方找到"导入"入口，在弹窗里选 Notion 导出包，把 zip 拖进去。这里有个前提：你对该空间要有编辑权限，否则传不上去。
4. 等待后台任务完成
ZIP 包是丢给后台任务处理的，提交后不用干等，该干嘛干嘛。过几分钟刷新空间，页面就会陆续出现。
5. 验收导入结果
打开侧边栏页面树，对照 Notion 原来的层级扫一遍：一级目录对应根页面，子文件夹对应子页面。文件名上那串 32 位 ID 后缀 Docmost 会自动剥掉，不用你手动改。
Markdown、HTML、通用 ZIP 与 Confluence 速览
Markdown 单文件：标准语法都认，标题、代码块、表格、任务列表没问题。文件会先转成 HTML，再存成 ProseMirror（Docmost 内部存文档的数据格式）结构，第一个标题会直接变成页面标题。
HTML 单文件：解析语义标签，列表、表格、图片都能保留，样式类属性会被清理，留下的都是内容结构。适合把旧网站的帮助页逐篇搬进来，提取不到标题时就用文件名顶上。
通用 ZIP 包：目录结构直接映射成页面层级，"文件夹 + 同名 .md 文件"会互相认成父子页面；正文里的相对链接会被重写指向新页面；md/html 之外的文件（图片、附件）一并收进存储。整个 docs 目录的 Markdown 批量导入，用它最顺手。
Confluence 导出包：走企业版模块，解析 Confluence 的 XML 导出，空间、页面、附件按原结构落库。如果你在做 Confluence 文档迁移，这是最省事的一条路。
导入前后各做一件事：3 项准备 + 4 项检查
导入前 3 项准备：
- 把文件统一成 UTF-8 编码，文件名去掉问号、反斜杠这类特殊符号
- 整理目录：想让哪层内容成为子页面，就先把它放进对应子文件夹
- 确认你对目标空间有编辑权限，顺便定好导入到哪个空间
导入后 4 项检查：
- 对照原平台扫一遍页面树，看层级有没有错位
- 点开两三处内部链接，确认跳转到了对应页面
- 翻到含图页面，看附件和图片是否显示正常 🔍
- 在搜索框搜一个专有名词，验证全文搜索已生效
⚠️ 最常踩的 3 个坑：现象、原因与一句话解法
- 导入失败，提示文件太大。原因：超过了单文件大小上限。解法：把大包拆开分批传，或删掉 zip 里没用的素材。
- 页面里图片全是破图。原因：正文用了绝对路径或外部临时链接。解法：打包前把图片放到 md 同目录，改成相对路径引用。
- 导入后页面全是平铺的，没有层级。原因：zip 里文件都堆在根目录，没有子文件夹。解法：压缩前先按章节建好子目录再打包。
知识库搬家的终点，是以后只维护一个地方。去 Docmost 空间页面列表点一下"导入"，把第一批文件送进去吧。
【免费下载链接】docmostDocmost is an open-source collaborative wiki and documentation software. It is an open-source alternative to Confluence and Notion.项目地址: https://gitcode.com/GitHub_Trending/do/docmost
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
