https://github.com/chenfeicqq/wiz-to-obsidian

https://github.com/chenfeicqq/wiz-to-obsidian

Last synced: 3 months ago
JSON representation

• Host: GitHub
• URL: https://github.com/chenfeicqq/wiz-to-obsidian
• Owner: chenfeicqq
• License: mit
• Created: 2023-08-27T02:15:08.000Z (about 1 year ago)
• Default Branch: main
• Last Pushed: 2023-09-02T05:53:32.000Z (about 1 year ago)
• Last Synced: 2023-09-03T07:15:21.262Z (about 1 year ago)
• Language: Python
• Size: 15.6 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
## 简介

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

+ markdown 笔记

  + 支持：附件

  + 图片：如果为 HTTP 链接会尝试下载图片至本地，下载失败（图片地址失效或无法访问）会继续使用 HTTP 地址

+ 普通笔记

  + 同 markdown 笔记，提取内容存为 markdown

  + **会丢失笔记的样式（加粗、字体、颜色、缩进 等）**

+ 任务清单（todolist2）

  + 不支持：附件、文档链接 等

> 建议 Obsidian 搭配 [obsidian-attachment-manager](https://github.com/chenfeicqq/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/账号名`