迁移指南
本指南帮助你从其他笔记和知识管理工具迁移到 WesCraft。我们支持从 Notion、Obsidian、语雀等主流平台导入数据，并尽可能保留原始格式和结构。
支持的迁移来源
| 来源平台 | 导入格式 | 保留内容 | 支持程度 |
|---|---|---|---|
| Notion | HTML / Markdown 导出 | 页面结构、文本、表格、数据库 | ★★★★☆ |
| Obsidian | Markdown 文件夹 | 文本、链接、标签、前置元数据 | ★★★★★ |
| 语雀 | Markdown 导出 / Lakebook | 文本、标题层级、图片 | ★★★★☆ |
| Markdown 文件 | .md 文件或文件夹 | 完整 Markdown 内容 | ★★★★★ |
| HTML 文件 | .html 文件 | 正文内容、基础格式 | ★★★☆☆ |
| CSV / Excel | .csv / .xlsx | 数据表结构 | ★★★★☆ |
| 纯文本 | .txt 文件 | 文本内容 | ★★★★★ |
从 Notion 迁移
步骤一：从 Notion 导出数据
- 在 Notion 左侧栏点击 Settings & Members
- 选择 Settings → Export all workspace content
- 导出格式选择 Markdown & CSV
- 勾选 Include subpages 和 Include databases
- 点击 Export 并下载 ZIP 文件
提示：如果只需要导出部分页面，可以在页面右上角菜单中选择 Export → Markdown & CSV。
步骤二：导入到 WesCraft
- 在 WesCraft 中打开设置（
Ctrl+,） - 选择 数据管理 → 导入
- 选择 从 Notion 导入
- 上传下载的 ZIP 文件
- 预览导入结构，选择目标位置
- 确认导入
Notion 特殊内容处理
| Notion 功能 | WesCraft 处理方式 |
|---|---|
| 页面嵌套 | 保留为父子页面结构 |
| 数据库 | 转换为 WesCraft 数据表 |
| 数据库视图 | 导入默认表格视图 |
| 关联属性 | 转换为关联字段 |
| 内嵌图片 | 下载并存储到本地 |
| Notion 公式 | 尽量转换，不兼容的标注为纯文本 |
| 嵌入内容 | 保留链接，不保留嵌入预览 |
| 评论 | 不导入 |
| 协作历史 | 不导入 |
| Toggle 块 | 转换为折叠块 |
| Callout 块 | 转换为引用块 |
| Synced Block | 转换为普通块（解除同步） |
已知限制
- Notion 的权限和分享设置不会迁移
- 自定义 Notion 集成（API）不迁移
- 部分复杂数据库公式可能无法完全转换
- 嵌入的第三方服务内容（如 Figma、Loom）仅保留链接
从 Obsidian 迁移
步骤一：定位 Vault 目录
找到你的 Obsidian Vault 目录：
- Mac：通常在
~/Documents/或自定义位置 - Windows：通常在
C:\Users\{用户名}\Documents\或自定义位置 - Linux：通常在
~/Documents/或自定义位置
步骤二：导入到 WesCraft
- 在 WesCraft 设置中选择 数据管理 → 导入
- 选择 从 Obsidian 导入
- 选择 Vault 根目录
- 配置导入选项
- 预览并确认导入
导入选项
| 选项 | 说明 | 默认 |
|---|---|---|
| 保留目录结构 | 按文件夹层级创建页面树 | 开启 |
| 转换 Wiki 链接 | [[链接]] 转为 WesCraft 页面引用 | 开启 |
| 导入标签 | #tag 转为 WesCraft 标签 | 开启 |
| 导入前置元数据 | YAML Front Matter 转为页面属性 | 开启 |
| 导入附件 | 图片和附件文件 | 开启 |
| 忽略 .obsidian 目录 | 跳过 Obsidian 配置文件 | 开启 |
| 忽略 .trash 目录 | 跳过回收站 | 开启 |
Obsidian 特殊内容处理
| Obsidian 功能 | WesCraft 处理方式 |
|---|---|
[[Wiki 链接]] | 转为页面引用链接 |
[[链接|显示文本]] | 保留显示文本的链接 |
![[嵌入]] | 转为页面嵌入块 |
#标签 | 转为 WesCraft 标签 |
| YAML Front Matter | 转为页面属性 |
| Mermaid 图表 | 保留为代码块（计划支持渲染） |
| Dataview 查询 | 转为纯文本（不执行） |
| Canvas | 不导入 |
| 社区插件数据 | 不导入 |
从语雀迁移
方式一：Markdown 导出
- 在语雀知识库设置中导出为 Markdown
- 下载导出的 ZIP 文件
- 在 WesCraft 中选择 从 Markdown 导入
- 上传 ZIP 文件
方式二：使用语雀开放 API
对于大量内容，推荐使用 API 方式：
- 在语雀开发者设置中获取 Token
- 使用 WesCraft 的语雀导入工具：
wescraft import yuque \
--token YOUR_YUQUE_TOKEN \
--repos "团队/知识库名" \
--target "/导入/语雀"
语雀特殊内容处理
| 语雀功能 | WesCraft 处理方式 |
|---|---|
| 文档 | 转为 WesCraft 页面 |
| 知识库结构 | 保留为页面树 |
| 表格 | 转为表格块 |
| 画板 | 不导入 |
| 数据表 | 尝试转换为数据表 |
| 小记 | 导入为收集箱项目 |
| 评论 | 不导入 |
| 协作成员 | 不迁移 |
通用 Markdown 导入
单文件导入
- 将
.md文件拖入 WesCraft 窗口 - 或在页面中点击 导入 → Markdown 文件
- 选择目标位置
文件夹批量导入
- 设置 → 数据管理 → 导入 → Markdown 文件夹
- 选择包含
.md文件的目录 - 配置选项：
- 是否保留目录结构
- 是否递归扫描子目录
- 文件编码（默认 UTF-8）
- 预览并确认
格式兼容性
WesCraft 支持以下 Markdown 扩展语法：
| 语法 | 支持 | 说明 |
|---|---|---|
| 标准 Markdown | ✅ | 完全兼容 |
| GFM 表格 | ✅ | GitHub Flavored Markdown 表格 |
| 任务列表 | ✅ | - [ ] / - [x] |
| 脚注 | ✅ | [^1] 引用 |
| 删除线 | ✅ | ~~文字~~ |
| 数学公式 | ✅ | $...$ 和 $...$ |
| 高亮 | ✅ | ==文字== |
| Mermaid | 🔄 | 保留为代码块 |
| 上标/下标 | ✅ | ^上标^ / ~下标~ |
| 定义列表 | ❌ | 转为普通文本 |
CSV / Excel 导入到数据表
CSV 导入
- 在数据表页面点击 导入 → CSV
- 上传 CSV 文件（要求 UTF-8 编码）
- 系统自动检测分隔符和表头
- 映射列到字段类型：
- 系统会自动推断字段类型（文本、数字、日期等）
- 你可以手动调整字段类型
- 预览前 10 行数据
- 确认导入
Excel 导入
- 点击 导入 → Excel
- 上传
.xlsx文件 - 选择要导入的 Sheet
- 同 CSV 流程映射和预览
- 确认导入
迁移注意事项
迁移前准备
- 备份原始数据：迁移前确保原平台的数据有完整备份
- 检查导出完整性：导出后检查文件数量和大小是否合理
- 整理目录结构：如果原始结构混乱，建议先在原平台整理
- 记录特殊内容：列出依赖原平台特有功能的内容，提前规划替代方案
迁移后检查
- 页面数量：确认导入的页面数量与预期一致
- 内容完整：抽查几个重要页面，确认内容无丢失
- 链接有效：检查页面间的引用链接是否正确关联
- 图片加载：确认图片和附件正常显示
- 标签保留：验证标签是否正确导入
常见问题
Q：导入后图片显示为空白？
A：可能是原始导出时图片使用了外链。建议在原平台导出时选择"包含图片"选项，或手动下载图片后重新上传。
Q：导入的页面层级错乱？
A：检查原始导出的文件夹结构是否与预期一致。某些平台导出时可能会打平层级。可在导入后在 WesCraft 中手动调整。
Q：导入的中文内容出现乱码？
A：确保文件编码为 UTF-8。如果是 CSV 文件，用文本编辑器打开后另存为 UTF-8 编码。
Q：大量数据导入速度慢？
A：建议分批导入，每批不超过 500 个文件。导入过程中避免进行其他操作。