有道云笔记迁移Obsidian全攻略：数据本地化与Markdown转换

1. 为什么需要将有道云笔记迁移到Obsidian

作为一款老牌云笔记服务，有道云笔记确实积累了不少忠实用户。但近年来，越来越多笔记爱好者开始转向Obsidian这类本地优先、支持Markdown的知识管理工具。我本人也是在去年完成了从有道云笔记到Obsidian的全面迁移，这个过程虽然有些技术细节需要注意，但绝对值得投入时间。

Obsidian相比有道云笔记有几个显著优势：首先是数据完全本地存储，不用担心服务突然关闭导致笔记丢失；其次是基于Markdown的纯文本格式，未来迁移到其他工具几乎零成本；再者是强大的双向链接和知识图谱功能，能真正建立起笔记间的有机联系。不过有道云笔记的导出过程确实有些"坑"，接下来我就详细分享下整个迁移流程中的关键步骤和避坑经验。

2. 迁移前的准备工作

2.1 工具准备清单

在开始迁移前，建议准备好以下工具：

• youdaonote-pull脚本（GitHub开源项目）
• Node.js运行环境（v14以上版本）
• html-to-markdown转换工具
• 文本编辑器（VS Code或Sublime Text）
• Obsidian客户端（建议最新稳定版）

提示：建议在迁移前先在测试目录操作，确认无误后再导入Obsidian库。我曾因为直接操作导致部分笔记格式错乱，不得不重新来过。

2.2 有道云笔记账号检查

登录有道云笔记网页版，检查以下几点：

1. 确认所有需要迁移的笔记都已同步到云端
2. 检查笔记中是否包含特殊格式（如表格、代码块等）
3. 记录笔记总数和占用空间，便于后续核对

3. 详细迁移步骤解析

3.1 使用youdaonote-pull导出笔记

这个开源脚本是目前最可靠的有道云笔记导出方案。具体操作：

bash复制git clone https://github.com/DeppWang/youdaonote-pull.git
cd youdaonote-pull
npm install
node index.js

运行后会提示输入有道云笔记账号密码。这里有个常见问题：如果开启了二次验证，需要在密码后追加验证码，格式为"密码,验证码"。

导出完成后，你会得到两种文件：

• .md文件：已经是Markdown格式的笔记
• .note文件：实质是HTML格式的网页源码

3.2 HTML到Markdown的转换处理

对于.note文件，需要使用html-to-markdown工具进行转换：

bash复制npm install -g html-to-markdown
html-to-markdown 输入文件.note > 输出文件.md

转换时需要注意几个关键点：

1. 复杂表格可能转换不完美，需要手动调整
2. 图片链接需要额外处理（下文会详述）
3. 代码块的语言标识可能丢失

我在实际操作中发现，转换后的文件有时会包含大量HTML注释，可以用以下命令批量清理：

bash复制find . -name "*.md" -exec sed -i '/<!--.*-->/d' {} \;

3.3 图片资源的处理方案

有道云笔记中的图片通常存储在其CDN上，直接转换后链接会失效。推荐两种解决方案：

方案一：下载图片到本地

bash复制# 使用wget批量下载图片
grep -oP 'http[^"]+\.(jpg|png|gif)' *.md | sort | uniq | wget -i -

方案二：替换为图床链接
如果不想管理本地图片，可以使用PicGo等工具上传到图床后批量替换链接。

4. Obsidian导入与后续优化

4.1 文件组织策略

直接将所有Markdown文件复制到Obsidian库的根目录不是个好主意。建议按以下结构组织：

code复制笔记库/
├── 日记/
├── 工作/
├── 学习/
└── 资源/
    ├── 图片/
    └── 附件/

可以使用脚本自动分类：

python复制# 示例分类脚本（需根据实际笔记内容调整）
import os
import shutil

for filename in os.listdir('.'):
    if filename.endswith('.md'):
        with open(filename) as f:
            content = f.read()
            if '会议' in content:
                shutil.move(filename, '工作/'+filename)
            elif '读书' in content:
                shutil.move(filename, '学习/'+filename)

4.2 元数据标准化处理

Obsidian支持YAML frontmatter，建议统一添加：

markdown复制---
created: 2023-07-15
tags: [笔记, 迁移]
---

可以使用以下命令批量添加：

bash复制for file in *.md; do
    echo -e "---\ncreated: $(date -r "$file" +%F)\n---\n$(cat "$file")" > "$file"
done

5. 常见问题与解决方案

5.1 转换后格式错乱

现象：列表层级丢失、表格变形
解决方案：

1. 使用Pandoc进行二次转换：

   bash复制pandoc -f html -t markdown -o output.md input.note
   

2. 手动修复时，推荐使用Obsidian的表格格式化插件

5.2 中文文件名乱码

原因：编码问题导致
解决方案：

bash复制convmv -f gbk -t utf-8 --notest *.md

5.3 附件文件处理

有道云笔记中的附件（如PDF、Word）需要单独导出：

1. 在网页版逐个下载
2. 使用开发者工具监控下载请求
3. 编写脚本批量获取（需处理登录态）

6. 迁移后的优化建议

完成基础迁移后，可以考虑以下优化措施：

1. 建立笔记关联：使用Obsidian的双向链接功能连接相关笔记
2. 添加标签系统：统一标签命名规范（如#工作/会议 #学习/编程）
3. 模板化处理：为不同类型笔记创建模板
4. 定期备份：虽然Obsidian是本地存储，但仍建议设置Git自动提交

我在迁移三个月后，又花时间对所有笔记进行了重构，这个过程中发现几个有用的插件：

• Dataview：高级查询和汇总
• Templater：强大的模板引擎
• QuickAdd：快速捕获新内容

整个迁移过程最耗时的其实是后续的整理阶段，建议预留足够时间。我现在每周还会花1-2小时优化笔记结构，这种持续迭代的方式比一次性完美迁移更实际。