打破笔记平台束缚：Python脚本实现有道云笔记完整备份指南

【免费下载链接】youdaonote-pull 📝 一个一键导出 / 备份「有道云笔记」所有笔记的 Python 脚本。 A Python script to export/backup all the notes of the "Youdao Note". 项目地址: https://gitcode.com/gh_mirrors/yo/youdaonote-pull

你是否曾为笔记数据被锁定在特定平台而苦恼？当需要迁移笔记到其他应用时，却发现有道云笔记没有提供完整的导出功能。今天，我将为你揭秘一个开源解决方案，让你轻松实现有道云笔记的完整备份和导出。

为什么你的笔记需要自由备份

在数字化学习时代，笔记是我们知识积累的重要载体。然而，许多笔记平台的设计让用户数据难以迁移，形成了所谓的"数据孤岛"。有道云笔记作为国内主流笔记工具，虽然提供了便捷的在线编辑体验，但导出功能的缺失让用户陷入了两难境地：要么继续使用，要么放弃多年积累的笔记。

这个Python脚本的出现，正是为了解决这一痛点。它通过模拟浏览器操作，调用有道云笔记的内部接口，实现了笔记内容的完整获取和格式转换。整个过程完全在本地运行，确保你的数据安全不会泄露到第三方服务器。

三步搭建你的个人笔记备份系统

第一步：环境准备与项目获取

首先确保你的计算机已安装Python 3.6或更高版本，这是运行脚本的基础要求。打开命令行工具，执行以下命令获取项目代码：

git clone https://gitcode.com/gh_mirrors/yo/youdaonote-pull
cd youdaonote-pull

项目依赖简单明了，仅需几个必要的Python包。安装依赖的命令如下：

pip install -r requirements.txt

核心依赖包括requests用于网络请求、markdownify用于格式转换，整个安装过程通常只需几分钟。

第二步：配置登录信息

由于有道云笔记的登录机制升级，脚本需要通过Cookie进行身份验证。你需要创建一个名为cookies.json的配置文件：

{
    "cookies": [
        [
            "YNOTE_CSTK",
            "你的Cookie值",
            ".note.youdao.com",
            "/"
        ],
        [
            "YNOTE_LOGIN", 
            "你的Cookie值",
            ".note.youdao.com",
            "/"
        ],
        [
            "YNOTE_SESS",
            "你的Cookie值", 
            ".note.youdao.com",
            "/"
        ]
    ]
}

获取Cookie的方法很简单：在Chrome浏览器中登录有道云笔记，按F12打开开发者工具，在Network标签中找到主请求，复制Cookie字段的值即可。整个过程完全在本地进行，你的登录信息不会被发送到任何第三方服务器。

第三步：个性化导出设置

编辑config.json文件，根据你的需求调整导出参数：

{
    "local_dir": "/Users/你的用户名/Documents/笔记备份",
    "ydnote_dir": "工作笔记",
    "smms_secret_token": "",
    "is_relative_path": true
}

这里有几个关键配置选项：

• local_dir：指定本地存储路径，留空则默认保存在项目目录下的youdaonote文件夹
• ydnote_dir：如果只想导出特定文件夹的笔记，可以填写文件夹名称
• is_relative_path：设置为true时，Markdown文件中的图片链接使用相对路径，便于跨设备使用

一键导出：让备份变得简单

完成配置后，只需运行一个简单的命令：

python pull.py

脚本会自动开始工作，它会：

1. 连接到有道云笔记服务器，获取你的笔记目录结构
2. 遍历所有笔记文件，按原格式下载到本地
3. 将Xml或Json格式的笔记自动转换为易读的Markdown格式
4. 下载所有图片资源，并更新Markdown中的图片链接

整个过程就像有一个无形的助手在为你整理笔记，你只需要泡一杯咖啡等待即可。

智能增量更新：保护你的修改

脚本设计了智能的增量更新机制。当你第二次运行导出命令时，它会：

• 比较有道云笔记中文件的修改时间与本地文件的修改时间
• 只下载新增或修改过的笔记文件
• 跳过已经存在且未修改的文件，节省时间和流量
• 保护你在本地对笔记的修改不被覆盖

这个设计特别适合定期备份的场景。你可以设置每周自动运行一次脚本，确保本地始终拥有最新版本的笔记备份。

格式转换：让笔记真正可用

有道云笔记导出的原始文件通常是Xml或Json格式，这些格式对人类阅读不友好。脚本的核心功能之一就是自动格式转换：

• Markdown标准化：将复杂的Xml结构转换为简洁的Markdown语法
• 图片本地化：下载有道云图床的图片到本地，确保离线可访问
• 附件保留：保持所有附件文件的完整性
• 目录结构：完全保留原有的文件夹组织方式

转换后的Markdown文件可以直接在Typora、Obsidian、VS Code等编辑器中打开，实现了真正的跨平台兼容。

实际应用场景

个人知识管理升级

许多用户使用这个脚本将有道云笔记迁移到Obsidian。Obsidian基于本地Markdown文件的特性，配合双向链接和知识图谱功能，能够构建更强大的个人知识体系。脚本确保迁移过程无缝衔接，所有笔记内容和结构都得到完整保留。

团队文档归档

对于团队使用的共享笔记，定期备份尤为重要。脚本可以设置为定时任务，每周自动备份团队的重要文档。备份的Markdown文件可以直接纳入Git版本控制系统，实现文档的版本管理和变更追踪。

跨平台同步方案

结合云存储服务如iCloud、Dropbox或OneDrive，你可以创建自己的跨平台笔记同步方案。在电脑上使用专业的Markdown编辑器，在手机上通过云存储应用查看和编辑，既享受了专业编辑工具的功能，又保持了移动端的便捷性。

技术原理揭秘

脚本的工作原理基于对有道云笔记Web接口的逆向分析。它模拟了浏览器访问笔记内容的完整流程：

1. 身份验证：使用Cookie模拟已登录状态
2. 目录获取：调用接口获取用户的笔记目录树
3. 内容下载：逐个请求笔记的详细内容
4. 格式解析：解析Xml/Json结构，提取文本、图片、附件等信息
5. 格式转换：将提取的内容重新组织为Markdown格式

这种方法的优势在于不依赖官方API，避免了API限制和变更带来的兼容性问题。即使有道云笔记更新了前端界面，只要后端接口保持不变，脚本就能继续工作。

安全性与隐私保护

你可能担心Cookie泄露的风险，但请放心：

• 所有操作都在你的本地计算机上完成
• Cookie信息只用于与有道云笔记服务器的直接通信
• 脚本不会将你的登录信息发送到任何其他服务器
• 你可以随时删除cookies.json文件

这种本地化处理的模式，相比使用第三方中转服务，提供了更高的安全性保障。

开始你的笔记自由之旅

数据主权是数字时代的重要权利。通过这个简单的Python脚本，你不仅获得了笔记备份的能力，更重要的是重新掌握了对自己知识资产的控制权。

无论你是想要迁移到其他笔记工具，还是单纯希望拥有本地备份，这个工具都能为你提供完整的解决方案。从今天开始，让你的笔记真正属于你自己，不再受任何平台的限制。

记住，知识只有在自由流动时才能发挥最大价值。现在就动手尝试，开启你的笔记自由之旅吧！

【免费下载链接】youdaonote-pull 📝 一个一键导出 / 备份「有道云笔记」所有笔记的 Python 脚本。 A Python script to export/backup all the notes of the "Youdao Note". 项目地址: https://gitcode.com/gh_mirrors/yo/youdaonote-pull