有道云笔记无损迁入 ima

为什么迁移会“断链”？

许多人尝试将笔记从有道云迁移到 ima，但最大的坑是图片丢失。ima 导入 Markdown 文件时会将其打散为独立条目，导致传统的相对路径图片引用（如 ![](./images/a.png)）全部失效。本技能的核心思路是导出 → 转格式 → 清理 → 下载远程图 → base64 嵌入 → 导入，在迁移过程中彻底解决图片路径依赖问题。

核心工作流

本方案基于 youdaonote-pull 获取源文件，并通过一系列 Python 脚本进行自动化处理。全流程共 7 步，其中获取 Cookie、导出目录设置及最终导入 ima 需要人工参与。

1. 格式转换：通过 convert_note_to_md.py 将有道云的 .note (本质为 HTML) 转为标准 .md。
2. 文件名治理：利用脚本去除附件繁琐的 32 位 HEX 前缀，并将可能导致渲染错误的空格替换为下划线。
3. 远程图下载：借助 download_remote_images.py，使用 Cookie 将存储在有道云 CDN（note.youdao.com）的图片拉取到本地。
4. Base64 嵌入：这是最关键的一步。embed_all_images.py 会将本地图片编码为 data:image/...;base64,... 格式并直接内联到 Markdown 文本中。文件自此变得完全“自包含”。

适用边界与注意点

• Cookie 有效性：建议获取 Cookie 后尽快完成操作，NTES_YD_SESS 对下载远程图至关重要。
• 文件体积限制：由于 base64 编码会增加约 30% 体积，单篇 .md 文件可能超过 ima 的 10MB 导入限制。若遇到此类情况，需提前拆分文件或压缩图片质量。
• 历史遗留图片：部分极老旧的历史图片可能因服务端源文件丢失而无法下载，这种情况下只能放弃部分配图。