youdaonote-pull

现在有道云笔记不能导出笔记，迁移笔记很麻烦。此脚本可将所有笔记下载到本地。

功能

• 可将所有笔记（文件）按原格式下载到本地
• 由于「笔记」类型文件下载后默认为 Xml 格式，不是正常笔记内容，默认将其转换为 Markdown 格式
• 由于有道云笔记图床图片不能在有道云笔记外显示，默认将其下载到本地，或指定上传到 SM.MS

使用步骤

一、导出前的准备工作

1、安装 Git、clone 项目

• 可根据 廖雪峰 Git 教程 安装 Git，测试是否安装成功

git --version

• 打开命令行软件，如 Terminal (macOS)、PowerShell (Windows)，clone 项目，里面包含脚本

pwd
git clone https://github.com/DeppWang/youdaonote-pull.git
cd youdaonote-pull

2、安装 Python3、安装依赖模块（包）

• 可根据 廖雪峰 Python 教程 安装 Python3，测试是否安装成功

python3 --version  # macOS/Linux
python --version   # Windows

• 安装依赖包

# macOS
sudo easy_install pip3      # 安装 Python3 Package Installer
sudo pip3 install requests     #  安装 requests
sudo pip3 install markdownify  #  安装 markdownify，用于 html 转化为 md

# Windows
pip install requests  
pip install markdownify

# 有问题可参考 https://www.liaoxuefeng.com/wiki/1016959663602400/1017493741106496

3、设置脚本参数配置文件 config.json

{
    "username": "your_youdaonote_username",
    "password": "your_youdaonote_password",
    "local_dir": "",
    "ydnote_dir": "",
    "smms_secret_token": ""
}

• username：必填，你的有道云笔记用户名
• password：必填，你的有道云笔记密码。ps：如果你记不到账号和密码，你可以参考 issue 的 cookie 登录
• local_dir：选填，本地存放导出文件的文件夹，不填则默认为当前文件夹
• ydnote_dir：选填，有道云笔记指定导出文件夹名，不填则导出所有文件
• smms_secret_token：选填， SM.MS 的 Secret Token（注册后 -> Dashboard -> API Token），用于上传笔记中有道云图床图片到 SM.MS 图床，不填则只下载到本地（youdaonote-images 文件夹），Markdown 中使用本地链接
• 提示：脚本单纯本地运行，不用担心你的账号密码泄露；建议使用 Sublime 编辑 config.json（避免编码格式错误）

示例：

• macOS

{
    "username": "[email protected]",
    "password": "12345678",
    "local_dir": "/Users/yanjie/Documents/youdaonote-pull/test",
    "ydnote_dir": "",
    "smms_secret_token": "SGSLk9yWdTe4RenXYqEPWkqVrx0Yexample"
}

• Windows

{
    "username": "[email protected]",
    "password": "12345678",
    "local_dir": "D:/Documents/youdaonote-pull/test",
    "ydnote_dir": "",
    "smms_secret_token": "SGSLk9yWdTe4RenXYqEPWkqVrx0Yexample"
}

二、运行导出脚本

python3 pull.py  # macOS/Linux
python pull.py   # Windows

效果：

三、多次导出

多次导出时，同样使用以下命令：

python3 pull.py  # macOS/Linux
python pull.py   # Windows

根据有道云笔记文件最后修改时间是否大于本地文件最后修改时间来判断是否需要更新。再次导出时，只会导出有道云笔记上次导出后新增、修改或未导出的笔记，不会覆盖本地已经修改的文件。但有道云笔记和本地不要同时修改同一个文件，这样可能会导致本地修改丢失！

更新时，会重新下载文件并覆盖原文件，图片也会重新下载。

注意事项

1. 如果你自己修改脚本，注意不要将 config.json 文件 push 到 GitHub（里面有账号密码）
2. 如果你不是开发者，可能对上面的命令行操作有所陌生，建议按步骤慢慢操作一遍。后续我会根据需求看是否应该提供网页下载
3. 请确认代码是否为最新，有问题请提交 issue

   git pull origin master  # 更新代码

原理

正常用户操作时，浏览器（前端）调用服务器（后端）接口，接口返回文件内容由前端渲染显示。原理是找到有道云笔记的接口，模拟操作接口，将前端显示改为存放到本地。Xml 转换为 Markdown，借助了 xml.etree.ElementTreeI

感谢（参考）

• YoudaoNoteExport

出发点

原来一直是有道云笔记的忠实用户，后面接触到了「所见即所得」的 Typora，有点用不惯有道云笔记了，想着有什么法子能电脑本地文件和有道云笔记同步，这样电脑使用 Typora，手机使用有道云笔记。发现有道云笔记有 Open API ，打算利用提供的 API，写两个脚本，一个 pull 所有文件到本地，一个 push 本地文件到云笔记。但 API 太难用了，N 多年没更新了，问客服也没更新的意思，开发到最后发现竟然没有 Markdown 文件的接口，醉了。遂放弃。

现在我使用 Typora + Dropbox（有版本历史记录） + MWeb 实现自动同步笔记和手机查看编辑的功能，很香。

最近给朋友推荐此方式，但发现有道云笔记最新的 Mac 客户端和网页端去除了导出所有笔记的功能！这是什么逻辑，怕用户跑了么。所以在原来 pull 脚本的基础上修改得到此脚本。

贡献

欢迎贡献代码，但有几个注意事项：

1. commit 请使用英文
2. 代码注解需要有中英文空格
3. 请确保通过测试
   • 在 macOS 和 Windows 环境中直接执行 pull.py 没有问题（你可以指定下载一个文件夹测试）
   • 在 test.py 配置中你的脚本参数（UserDefine），运行测试脚本 test.py 没有问题

捐赠

有小伙伴说可以放个赞赏码什么的，但考虑捐赠的意义，如果小伙伴有想捐赠的，可以支持一下「微澜图书馆」这个流动儿童图书馆公益项目。想让我知道你的捐赠的话，就把我设为你的「介绍人」吧

• 微澜图书馆公众号