Obsidian 邮件自动导入插件使用教程：Gmail + QQ 邮箱配置、授权码获取与完整上手指南

✨ 写在前面

很多人都有这个习惯：

重要通知留在邮箱里
订单、账单也在邮箱里
项目沟通、注册提醒、学习资料还是在邮箱里

时间一长，邮箱就会变成一个“什么都有，但什么都不好找”的地方。
真正麻烦的不是收不到邮件，而是：

你明明知道它很重要，但它一直困在邮箱里，没真正进入你的知识库。

所以我做了一个 Obsidian 邮件自动导入插件。

它的目标非常直接：

📥 把 Gmail 和 QQ 邮箱里的邮件，自动整理成 Markdown 笔记，沉淀进 Obsidian。

这篇文章我不想写得太“说明书”。
我更想像朋友带你配置一样，把最关键的东西讲明白：

这个插件到底能干什么
第一次安装后会看到什么
Gmail 和 QQ 邮箱该怎么填
为什么 Gmail 要用 App Password
为什么 QQ 邮箱要用授权码
哪些设置建议新手先保守一点
连不上、导不进来时，先查哪里

如果你是第一次碰 IMAP、授权码、App Password，也没关系。
你跟着这篇一步一步来，基本就够了。🙌

📌 这个插件到底是干什么的？

一句话讲清楚：

它会通过 IMAP 连接你的邮箱，把邮件内容写进 Obsidian，变成 Markdown 文件。

也就是说，你不需要：

手动复制邮件内容
一封封新建笔记
每次都自己整理基础格式

插件会把这些重复动作接过去，你只需要负责：

连接好邮箱
选好同步规则
决定哪些邮件值得留下来

这个分工其实很舒服：

📮 邮箱负责收件
🧠 Obsidian 负责沉淀
✍️ 你负责筛选真正有价值的信息

🚀 现在这个插件已经能做什么？

当前版本已经支持这些功能：

✉️ 支持添加 Gmail
✉️ 支持添加 QQ 邮箱
🔌 支持测试连接
📥 支持导入未读邮件或全部邮件
♻️ 自动去重，避免重复导入
📂 自动创建标准目录结构
🛠️ 支持自定义根目录
🗂️ 支持不同邮箱写入不同目录
⚡ 支持在 Obsidian 里一键同步

如果你只想记住一个重点，那就是：

邮箱里的新邮件，可以被稳定地转换成你知识库里的笔记。

这才是它最核心的价值。
不是“把邮箱搬家”，而是“把有用内容沉淀下来”。

🗂️ 安装后会自动创建什么目录？

如果你打开了“自动创建标准目录结构”，插件会帮你先把常用文件夹搭好。

默认根目录是：

TEXT

个人笔记/邮件入库

默认会创建这些子目录：

TEXT

个人笔记/邮件入库/待整理
个人笔记/邮件入库/账单凭证
个人笔记/邮件入库/项目沟通
个人笔记/邮件入库/账号通知
个人笔记/邮件入库/精华摘要

这个设计的好处很明显：

第一次用时不容易乱
后面做归档更顺手
Dataview、搜索、筛选也更方便

当然，如果你不喜欢这个命名，也可以自己改根目录，比如：

TEXT

邮件系统
Inbox/Email
收件箱/邮件归档

🔧 怎么安装和启用插件？

这部分不复杂，照着走就行。

第一步：把插件放进 Obsidian 插件目录

插件目录名称是：

TEXT

obsidian-email-importer

第二步：打开 Obsidian

进入：

TEXT

设置 → 第三方插件

第三步：如果安全模式还开着，先关掉

不然社区插件不会加载。

第四步：启用插件

在插件列表里找到：

TEXT

Email Importer

把它打开。

第五步：进入插件设置

启用后，点进插件设置页，就可以开始配置邮箱了。

⚙️ 插件设置项，逐个讲人话

很多人不是不会装插件，而是卡在“这个设置到底填什么”。

下面我把最重要的项，用尽量直白的话讲一下。

1）输出目录

这是：

全局默认输出目录

如果某个邮箱没有单独设置自己的输出目录，就会写到这里。

默认一般是：

TEXT

个人笔记/邮件入库/待整理

适合先把所有邮件统一接住，再慢慢分流。

2）标准根目录

默认值：

TEXT

个人笔记/邮件入库

如果你改成：

TEXT

邮件系统

那插件会自动创建：

TEXT

邮件系统/待整理
邮件系统/账单凭证
邮件系统/项目沟通
邮件系统/账号通知
邮件系统/精华摘要

3）自动创建标准目录结构

这个开关的意思是：

插件加载时，自动帮你创建一套标准文件夹

我建议：

TEXT

开启

对第一次用的人最友好，省得你还要手动建目录。

4）立即创建标准目录

这是一个“手动执行一次”的按钮。

适合这些场景：

你刚改了根目录名称
你想立刻把目录建出来
你怀疑之前没有创建成功

5）默认分类

这是导入邮件后，会写进笔记 frontmatter 里的默认分类。

一般可以先用：

TEXT

待整理

它的好处是后续你可以：

统一筛选
用 Dataview 做列表
批量二次整理

6）摘要长度

这个值控制：

每封邮件正文最多截取多少字符用于摘要

常见可用值：

TEXT

300
500
800

如果你的邮件通常比较长，我建议直接用：

TEXT

这是一个比较平衡的值。

📨 每个邮箱下面的设置项是什么意思？

Gmail 和 QQ 邮箱下面，基本都会有一套类似配置。
你理解一遍，后面配哪个邮箱都差不多。

1）启用

控制这个邮箱是否参与同步。

如果关掉：

插件不会去读这个邮箱

2）显示名称

这个主要是给你自己看。

你可以填：

TEXT

Gmail
QQ邮箱
工作邮箱
学习邮箱

它不会影响连接成功与否，但会影响你后面看设置时是否一眼看明白。

3）IMAP 主机

邮箱服务器地址。

Gmail：

TEXT

imap.gmail.com

QQ 邮箱：

TEXT

imap.qq.com

通常不要乱改。

4）端口

推荐都用：

TEXT

这是最常见、也最稳的 IMAP SSL 端口。

5）用户名

这里填的是：

完整邮箱地址

例如：

TEXT

yourname@gmail.com
123456789@qq.com

注意别填成：

昵称
备注名
只填前半段账号

6）密码 / 授权码

这一项最容易填错，也是最容易导致连接失败的地方。⚠️

大多数情况下：

Gmail 不能直接填普通登录密码
QQ 邮箱也不建议直接填登录密码

通常应该填的是：

TEXT

Gmail：App Password
QQ邮箱：授权码

这个区别一定要记住。

7）文件夹

表示从邮箱的哪个文件夹读取邮件。

默认：

TEXT

INBOX

也就是收件箱。

如果你没有特别需求，先别改。

8）邮箱专属输出目录

这个非常实用。

你可以把不同邮箱分流到不同目录，比如：

TEXT

Gmail → 个人笔记/邮件入库/Gmail
QQ邮箱 → 个人笔记/邮件入库/QQ邮箱

如果这里留空，就会回退到全局输出目录。

9）搜索条件

这个决定同步哪些邮件。

常见值：

TEXT

UNSEEN
ALL

含义分别是：

UNSEEN：只同步未读邮件
ALL：同步全部邮件

如果你是第一次用，我强烈建议先用：

TEXT

UNSEEN

原因很简单：

更稳
不容易一下子导太多
更方便你先做小范围测试

10）每次最多导入

控制一次同步最多拉多少封邮件。

新手起步建议：

TEXT

5
10

真的不建议一开始就开很大。
先跑通，再放量，会省很多事。

11）同步后标记为已读

这个开关控制：

导入完成后，是否顺手把邮箱里的邮件标记为已读

我建议第一次先这样：

TEXT

关闭

因为这样更保险，不会影响你邮箱原本的阅读状态。

12）测试连接

这个按钮非常重要，别跳过。

推荐顺序是：

先把配置填好
先点测试连接
成功后再开始同步

这会比你直接硬同步省很多排查时间。

📮 怎么添加 Gmail？

如果你要先配 Gmail，直接照着下面填：

TEXT

IMAP 主机：imap.gmail.com
端口：993
用户名：你的 Gmail 地址
密码：Google App Password
文件夹：INBOX
搜索条件：UNSEEN

这里最关键的一点是：

Gmail 大多数情况下不能直接填 Google 登录密码，要用 App Password。

🔐 Gmail 的 App Password 怎么获取？

先说结论：

你要先开 Google 两步验证，然后再生成 App Password。

前提条件

你必须先开启：

TEXT

2-Step Verification

也就是 Google 的两步验证。

大致操作路径

登录你的 Google 账号
进入安全设置
开启两步验证
找到：

TEXT

App passwords

生成一组新的 16 位密码
复制到插件的“密码 / 授权码”里

最后你真正填进插件里的其实是：

TEXT

Gmail → 密码 / 授权码 → 16 位 App Password

如果你看不到 App passwords，常见原因有这些

还没开启两步验证
账号是公司/学校统一管理账号
开启了高级保护
当前账号安全策略限制了第三方登录

能不能直接填 Gmail 登录密码？

大多数情况下：

❌ 不建议
❌ 很可能直接失败

所以别在这里硬试普通密码，容易白折腾。

📫 怎么添加 QQ 邮箱？

如果你要配 QQ 邮箱，照这个填就行：

TEXT

IMAP 主机：imap.qq.com
端口：993
用户名：你的 QQ 邮箱地址
密码：QQ 邮箱授权码
文件夹：INBOX
搜索条件：UNSEEN

这里同样要注意：

QQ 邮箱通常也不要直接填登录密码，而是填授权码。

🧾 QQ 邮箱授权码怎么申请？

先说结论：

QQ 邮箱给第三方工具登录时，一般要先开 IMAP/SMTP，然后使用授权码。

常见操作路径是：

TEXT

1. 登录 https://mail.qq.com
2. 点击 设置
3. 进入 账户
4. 找到 POP3/IMAP/SMTP/Exchange/CardDAV/CalDAV 服务
5. 开启 IMAP/SMTP 服务
6. 完成手机或安全验证
7. 获取授权码
8. 把授权码填入插件的“密码 / 授权码”

最后你填进去的应该是：

TEXT

QQ邮箱 → 密码 / 授权码 → 授权码

这里顺手提醒 3 点

授权码不是 QQ 登录密码
开启时常常需要手机验证
如果授权码失效，重新生成一份即可

✅ 推荐给新手的起步配置

如果你不想一开始就折腾太多，直接按下面来。

Gmail 推荐配置

TEXT

启用：开
显示名称：Gmail
IMAP 主机：imap.gmail.com
端口：993
用户名：你的 Gmail 地址
密码：App Password
文件夹：INBOX
邮箱专属输出目录：个人笔记/邮件入库/Gmail
搜索条件：UNSEEN
每次最多导入：5
同步后标记为已读：关

QQ 邮箱推荐配置

TEXT

启用：开
显示名称：QQ邮箱
IMAP 主机：imap.qq.com
端口：993
用户名：你的 QQ 邮箱地址
密码：QQ 邮箱授权码
文件夹：INBOX
邮箱专属输出目录：个人笔记/邮件入库/QQ邮箱
搜索条件：UNSEEN
每次最多导入：5
同步后标记为已读：关

这套配置的优点是：

✅ 不容易一下同步太多
✅ 不会乱动邮箱阅读状态
✅ 出问题时也比较容易回退

▶️ 第一次怎么开始用？

我建议按这个顺序：

第 1 步：先填好 Gmail / QQ 配置

别急着同步，先把信息填全。

第 2 步：先点“测试连接”

如果测试连接都没过，直接同步大概率也不会顺。

第 3 步：再点击开始同步

或者在命令面板运行：

TEXT

同步 Gmail / QQ 邮件到知识库

第 4 步：回到 Obsidian 看导入结果

默认会写到你设置的输出目录里。

你最好先看一下：

文件名是否正常
分类是否正常
内容有没有重复

🧪 第一次使用时，我最建议你保守一点

第一次跑的时候，建议这样配：

TEXT

搜索条件：UNSEEN
每次最多导入：5
同步后标记为已读：关

为什么？

因为这样：

不会一下导很多封邮件
不会破坏邮箱原本状态
真出问题时，回退成本也低

一句话总结就是：

第一次先求稳，不要求多。

🛠️ 常见问题排查

1）测试连接失败

先按这个顺序排查：

邮箱地址有没有填完整
App Password / 授权码有没有填错
Gmail 有没有开两步验证
QQ 邮箱有没有开 IMAP/SMTP
主机和端口是不是正确

很多问题其实不是插件坏了，而是授权信息填错了。

2）为什么同步不到邮件？

优先检查：

搜索条件是不是太严格
文件夹是不是 INBOX
你是不是设置成只同步未读，但当前根本没有未读邮件

3）为什么导入数量比想象中少？

通常是这几个原因：

搜索条件有限制
每次最多导入数量有限制
插件有去重机制

这不一定是坏事，反而说明它没有乱导。

4）为什么我建议一开始先关闭“同步后标记为已读”？

因为这样最安全。

尤其是第一次测试时，你往往还不确定：

是否导对了
是否会重复
是否会影响你后续在邮箱里的处理流程

所以先别动阅读状态，等确认稳定后再决定要不要开。

💡 更推荐的使用方式

我自己的建议不是：

把所有邮件一股脑搬进 Obsidian

而是：

先自动导入
再人工整理
只保留真正值得沉淀的内容

这样做的好处很现实：

邮箱继续负责接收
Obsidian 专心负责知识沉淀
你的知识库不会变成第二个垃圾收件箱

这个边界一旦想清楚，整个系统会顺很多。🧠

✅ 最后总结

如果你只想记最关键的几句，那记下面这几条就够了：

TEXT

Gmail 用 App Password
QQ 邮箱用 授权码
先 测试连接
再 开始同步
第一次建议用 UNSEEN + 每次 5 封
同步后标记为已读，先关掉

这个插件真正想解决的问题，不是“邮箱搬家”，而是：

把真正有价值的邮件，稳定地沉淀进你的 Obsidian。

如果你本来就把 Obsidian 当成个人知识库，那这一步其实非常值得做。📮➡️📝

仓库地址：https://github.com/haocenchen-debug/obsidian-email-importer

参考资料

Google 官方：App Password 说明
https://support.google.com/accounts/answer/185833
Google 官方：App Password 使用与排错
https://support.google.com/accounts/answer/2461835
Google Workspace 官方：第三方客户端与 IMAP / App Password 说明
https://support.google.com/a/answer/9003945
华为支持：QQ 邮箱授权码获取说明（引用 QQ 邮箱官方设置路径）
https://consumer.huawei.com/cn/support/content/zh-cn15872097

✨ 写在前面

📌 这个插件到底是干什么的？

🚀 现在这个插件已经能做什么？

🗂️ 安装后会自动创建什么目录？

🔧 怎么安装和启用插件？

第一步：把插件放进 Obsidian 插件目录

第二步：打开 Obsidian

第三步：如果安全模式还开着，先关掉

第四步：启用插件

第五步：进入插件设置

⚙️ 插件设置项，逐个讲人话

1）输出目录

2）标准根目录

3）自动创建标准目录结构

4）立即创建标准目录

5）默认分类

6）摘要长度

📨 每个邮箱下面的设置项是什么意思？

1）启用

2）显示名称

3）IMAP 主机

4）端口

5）用户名

6）密码 / 授权码

7）文件夹

8）邮箱专属输出目录

9）搜索条件

10）每次最多导入

11）同步后标记为已读

12）测试连接

📮 怎么添加 Gmail？

🔐 Gmail 的 App Password 怎么获取？

前提条件

大致操作路径

如果你看不到 App passwords，常见原因有这些

能不能直接填 Gmail 登录密码？

📫 怎么添加 QQ 邮箱？

🧾 QQ 邮箱授权码怎么申请？

这里顺手提醒 3 点

✅ 推荐给新手的起步配置

Gmail 推荐配置

QQ 邮箱推荐配置

▶️ 第一次怎么开始用？

第 1 步：先填好 Gmail / QQ 配置

第 2 步：先点“测试连接”

第 3 步：再点击开始同步

第 4 步：回到 Obsidian 看导入结果

🧪 第一次使用时，我最建议你保守一点

🛠️ 常见问题排查

1）测试连接失败

2）为什么同步不到邮件？

3）为什么导入数量比想象中少？

4）为什么我建议一开始先关闭“同步后标记为已读”？

💡 更推荐的使用方式

✅ 最后总结

参考资料

你希望这篇文章补充什么？

最新建议