Obsidian Importer 使用指南：多格式笔记导入工具

【免费下载链接】obsidian-importer Obsidian Importer lets you import notes from other apps and file formats into your Obsidian vault. 项目地址: https://gitcode.com/gh_mirrors/ob/obsidian-importer

Obsidian Importer 是一个功能强大的 Obsidian 插件，允许您从其他应用程序和文件格式将笔记导入到 Obsidian 知识库中。该工具将各种格式的笔记转换为纯文本 Markdown 文件，帮助用户无缝迁移数据到 Obsidian 的高效环境中。

功能特性

Obsidian Importer 支持从多种主流笔记应用和文件格式导入数据：

• Apple Notes 笔记导入
• Bear 笔记导入
• Evernote 笔记导入
• Google Keep 笔记导入
• Microsoft OneNote 笔记导入
• Notion 笔记导入
• Roam Research 笔记导入
• HTML 文件导入
• Markdown 文件导入

安装和使用

安装方法

1. 在 Obsidian 中打开设置
2. 进入社区插件页面
3. 搜索 "Importer" 并安装
4. 启用插件即可开始使用

项目开发环境搭建

如果您想要参与项目开发或自行构建，需要先克隆项目：

git clone https://gitcode.com/gh_mirrors/ob/obsidian-importer
cd obsidian-importer

然后安装项目依赖：

npm install

开发命令

项目提供了以下 npm 脚本命令：

• npm run dev - 开发模式构建
• npm run build - 生产环境构建
• npm run version - 版本更新
• npm run lint - 代码检查

项目结构

Obsidian Importer 采用清晰的项目结构组织代码：

obsidian-importer/
├── src/                    # 源代码目录
│   ├── formats/           # 各格式导入器
│   │   ├── apple-notes.ts
│   │   ├── evernote-enex.ts
│   │   ├── notion.ts
│   │   └── ...其他格式
│   ├── main.ts           # 主入口文件
│   └── util.ts          # 工具函数
├── tests/               # 测试文件
├── images/             # 图片资源
├── manifest.json       # 插件清单
├── package.json        # 项目配置
└── README.md          # 项目说明

技术实现

项目基于 TypeScript 开发，使用 esbuild 进行构建。主要依赖包括：

• @zip.js/zip.js - ZIP 文件处理
• joplin-turndown-plugin-gfm - Markdown 转换
• protobufjs - Protocol Buffers 支持
• xml-flow - XML 数据处理

贡献指南

项目欢迎社区贡献，特别是对新格式的支持。如果您发现缺少某种格式，可以参与开发。项目维护了一些带有奖励标签的 issue，鼓励开发者参与解决。

致谢

Obsidian Importer 的成功离不开众多开发者的贡献：

• Akos Balasko 提供 Evernote 导入功能（基于 Yarle）
• Dale DeSilva 实现 Google Keep 导入
• Arthur Tyukayev 开发 Bear 导入功能
• Joshua Taz Rein 贡献 Notion 导入
• 以及其他众多贡献者

注意事项

使用导入功能时，请确保：

• 备份您的原始数据
• 检查导入后的格式转换是否正确
• 注意附件文件的处理方式

Obsidian Importer 为笔记迁移提供了便捷的解决方案，让用户能够轻松地将多年积累的笔记内容统一到 Obsidian 生态系统中，享受链接思考和知识管理的便利。

【免费下载链接】obsidian-importer Obsidian Importer lets you import notes from other apps and file formats into your Obsidian vault. 项目地址: https://gitcode.com/gh_mirrors/ob/obsidian-importer