README.md

简介

为知笔记 转 Obsidian（Markdown），支持：

• markdown 笔记
  • 支持：附件
  • 图片：如果为 HTTP 链接会尝试下载图片至本地，下载失败（图片地址失效或无法访问）会继续使用 HTTP 地址
• 普通笔记
  • 同 markdown 笔记，提取内容存为 markdown
  • 会丢失笔记的样式（加粗、字体、颜色、缩进 等）
• 任务清单（todolist2）
  • 不支持：附件、文档链接 等

建议 Obsidian 搭配 obsidian-attachment-manager 插件使用，获得更好的附件管理体验。

基本原理

1. 为知笔记 会在本地“笔记文件夹”下存放数据库文件 index.db
2. 为知笔记 ziw 本质是 zip 文件
3. 笔记的原始内容存放在 zip 文件中的 index.html
4. todolist2 格式的任务清单在 ziw 中有单独的文件 wiz_todolist.xml 记录了任务状态

转换的过程：

1. 读取 index.db 获取 笔记、附件 等信息；
2. 遍历笔记，解压 ziw 文件；
3. 根据笔记类型进行转换；

测试环境

• macos 13.2.1
• python 3.9
• 为知笔记 4.2.691

使用必读

1. 不支持加密笔记，需要先在 为知笔记 中进行解密；
2. 笔记的附件请提前下载至本地，未找到附件会继续执行，需要手工处理；
3. 转换失败会输出日志，继续转换后续的笔记；
4. 转换会在笔记文件夹所在路径下创建2个文件夹
   • {笔记文件夹名}_w2o，转换后的笔记文件夹
   • {笔记文件夹名}_temp，转换过程中的临时文件夹（用于解压 ziw 文件），转换后可以删除
5. 支持断点续转，转换过程中会记录转换成功的笔记，重复执行会跳过已转换的笔记
   • 会在 {笔记文件夹名}_w2o 目录下创建 convertor.db 文件，转换完成后可以删除

入口

src/main.py

笔记文件夹参考：Wiz安装路径/My Knowledge/Data/账号名