功能

使用python将为知笔记中的所有笔记都导出到本地, 转化为纯markdown文本文件.

前置准备

• 启动picgo(version >= 2.1.0), 并配置picgo图床,测试上传成功
• 将所有加密笔记取消加密
• conf/config.yaml 配置位置笔记的用户名和密码

导包, 运行 main.py 即可.

注意

• 笔记标题和目录名不要出现 /等和文件分隔符冲突的特殊字符, 无法导出
• 我 picgo 配置的是github图片,不允许出现同名文件名, 会导致上传错误, 导致部分图片上传错误
• 为知笔记应用不要打开协作笔记tab页, 否则影响程序读取读取该笔记的数据.

项目结构

├── conf
│   ├── conf.yaml  // 配置文件, 需要配置帐号密码
│   └── logging.yaml // 日志配置
├── log.py
├── main.py // 主程序入口
├── output
│   ├── db
│   │   └── sync.db // sqlite3 记录笔记同步记录和笔记图片同步记录
│   ├── export_image // 笔记图片, 目录结构为: 笔记的文件夹目录/笔记名/笔记下所有图片
│   ├── note         // 所有导出 markdown 笔记
│   └── log
│       └── log.log // 日志
├── sync // 同步程序
└── test // 测试相关

相关问题

协作笔记如何处理

协作笔记使用ws通信, 返回特定的数据格式, 需要写解析器将其解析为markdown纯文本. GitHub - websocket-client/websocket-client: WebSocket client for Python

因为使用ws通信, 为知笔记应用不要打开协作笔记, 否则影响程序读取读取该笔记的数据.

如何处理笔记附件

忽略笔记中的附件, 不处理.

如何处理加密笔记

将所有加密笔记取消加密, 当作常规笔记处理, 避免处理加密笔记的复杂性. WizNote 加密笔记

如何处理笔记中的图片

程序将笔记中的图片下载到本地, 通过picgo http api上传图片并替换图片地址.(请启动picgo, 并配置picgo图床,测试上传成功) 高级技巧 | PicGo

如何处理笔记的tag

忽略原先为知笔记中的tag, 将笔记的目录作为tag.

其他

半吊子python, 程序还有很多不完善之处. 待其他人完善.

程序的默认导出约定更多是符合我自己的期望, 而不是做成一个通用的工具产品. 待其他人有时间完善吧, 比如:

• 忽略原先为知笔记中的tag, 将笔记的目录作为tag, 因为我自己不用为知的tag.
• 忽略加密笔记的处理(因为我没有几篇加密笔记,直接取消加密即可, 不用为了处理加密笔记的解析写多余的代码)
• ...等等

待完善之处

• 程序可以打包成app, exe, 让不懂程序的人也能轻松使用
• 配置导出参数, 可以更好的定制化导出
• 上传到图床, 图片名不能相同. (目标图片名可以用时间戳, 同步笔记图片表记录目标文件名, 导出的时候替换目标文件名)
• 公式, 流程图解析可能存在问题.

参考文章

[WizNote 为知笔记 macOS 本地文件夹分析 | ZRONG's BLOG

server-architecture.md

GitHub - WizTeam/wiz-editor

为知笔记API文档