[Plugin]导入到 Notion

[Kenshin]

📝 描述

全新 2.0 版来啦 🎉

导入全文（含标注色）到 Notion，并支持题图、Favicon、稍后读标签、自定义标签、标注的一站式导入工具。

🆕 全新 2.0 版

在 2024 年 11 月 16 日，Notion 私有 API 再次出现无法使用的问题，这让我决定彻底弃用 Notion 私有 API 方案，转向公开 API 方案。

由于采用公开 API，支持一键授权（不在有繁琐的授权过程），加持简悦完美的阅读模式，同时支持 导入带标注色的全文、知乎公式、超长文章的导入。

📥 地址

https://simpread.ksria.cn/plugins/details/OpaogjT8KJ

📺 视频

视频演示包含了一整套知识笔记整理方案，这套方案已同步更新到 配置库 · 高级版方案

https://www.bilibili.com/video/BV13kq2YHEpC

✍️ 写在前面

我也是 Notion 重度用户，一直在使用的简悦就是用 Notion 来管理的，专门为此写了一篇 《聊了聊如何用 Notion 管理简悦》 的文章。

简悦早在 1.1.4 版就接入了 Notion，可见对 Notion 的支持 😄

为了更好的将正文导入到 Notion，简悦使用了一些 Notion 私有 API，虽然得到了很好的效果，也带来了「一些隐患」，比如：2022年7月23日发生了 标题含有 CJK 字符就会出现无法保存的问题，但好在这次事件 Notion 官方快速修复了。

而在 2022年12月6日发生了 因为 API 后端参数修改导致无法导入到 Notion Page 的问题，我也是第一时间就反馈给了 Notion 但一直没有得到反馈，因并不算是 Bug，而 API 修改 Notion 也没有通知（私有 API 缘故），所以简悦就显得有些「被动了」。

为了避免这种情况再次发生，简悦官方决定将 导入到 Notion 功能 插件化，即：使用插件的方式实现导入到 Notion 的功能。

此插件就是为了这个事情开发的。

🔄 与扩展端的区别

通过上表可以看到，除了无法在稍后读中使用外（下个版本支持），扩展端具有的功能，插件端也都具有，但插件端还可支持随时更改不同的 Page 功能。

同时，因为插件的更新不依赖与扩展端，可随时更新，具有更好的时效性。

注意，导入到 Notion 扩展端已被废弃。

📦 配置库

简悦 · 配置库 是简悦官方推出的一套针对新用户的极简配置方案，方便新用户用最快的方式使用简悦的各种高级服务，配置库内置了常用的双链笔记用法，如：Notion、Obsidian、Logseq、Roam Research，同时包含了简悦在阅读模式上的一些常规插件：Live Editor、题图、Safari 阅读模式等。

目前配置库包含了 Notion 的一站式配置方案，细节 请看这里。

📚 一站式教程

https://www.yuque.com/kenshin/simpread/zx3bcz

🗂 选项

随便进入一个页面 e.g. https://sspai.com/post/71576 并进入 阅读模式 → 右下角 → 动作 → 插件触发器

按照下图所示即可查看此插件的选项页。（注意：如果你的界面没有插件触发器，请根据此 解决方案 修复。

🌟 功能

1. 可导入当前页面的题图、Favicon、来源等。

   

2. 导入正文到 Notion，因为使用了公开 API，所以可以完美适配 知乎公式 · 表格及包含大量代码段 的页面

3. 导入带标注色的全文 查看效果

   此功能需要 简悦高级账户，可通过 此链接 升级

   

4. 内置 Cloudinary 图床

   

5. 快捷导出（在导入可选择任意 Notion Page）

   

🔑 如何授权

1. 先安装 此插件 如果使用了同步助手的自动同步功能，请使用 插件管理器 安装。

2. 复制 简悦的模板 到你的 Notion 空间（ 2.0 版已新增对不同结构 Notion Page 的兼容性支持，但为更好地展示导入效果，请 务必使用简悦提供的导入模板）

   

3. 授权并获取 Notion 的空间与页面（由于采用公开 API，授权过程非常简单）。

   2024-12-08_15-06-04.mp4

🔂 旧版本升级说明

如果你已使用 1.x 版（旧版本），首次升级后会出现如下截图，此时需重新授权 Notion 才能使用。（授权方式与上面一致）

⌨️ 快捷键

n t → 一键导入全文到 Notion

q n t → 选择不同的 Page 后导入全文到 Notion

z n t → 配合自动化辅助增强插件使用

💡 用法

#4954 (comment)

🔌 导入到 Notion 辅助增强

可同时配套 导入到 Notion 辅助增强 插件，包括：导入描述、稍后读的备注、稍后读标签、自定义标签、标注以及删除重复导入的 Page 等功能。

⤴️ 安装与升级

• 没有【使用同步助手 · 自动同步】的话，可通过 此链接 安装。

• 已经【使用同步助手 · 自动同步】的话，请使用 插件管理器 安装。

🗒️ 更新日志

2.0.3

• Optimize 授权成功后 Notify 提示接下来选择 Notion Page

• Add 授权成功选择 Notion Page 下拉列表闪动效果

• Add 授权成功默认选择第一个 Notion Page

• Add 加入 zhihu.com 智能判断列表

2.0.2

• Add 全局方法 SRRefreshToken 用于 导入 Notion 辅助增强插件获取最新的 token 与 `dbid

• Optimize 快捷导出功能，无需保存仅切换 Notion Page 后就可以生效。（注意：需要 导入 Notion 辅助增强插件 版本为 2.0.2 版（含以上）才能生效。

2.0.1

• Optimize 导入到 Notion Page 的锚点从 Name 改为 title 用以适配更广泛的 Database 结构

• Optimize 快捷导出当更改 Notion Page 退出快捷导出可还原为上一次的 Page，单击保存后才会保存当前 Page

• Fix 几处结构错误导致异常的情况

2.0.0

• Rework 重构了导入到 Notion 的逻辑，弃用私有 API，使用公开 API

• Add 基于 Notion 公开 API 的一键授权方案

• Add 导入带标注色的全文

• Add 版本检查（选项卡左下角版本号，点击可验证是否有新版）

• Update 选择任意 Page 导入 时可自动匹配 Notion 辅助增强插件

• Update 选项卡 2.0

• Optimize Cloudinary 图床自动判断，即当遇到某些域名时，强制更改上传方式，以便适应更多上传规则。

1.3.0

• Add 内置 Cloudinary 账户

1.2.0

• Add 导入到 Cloudinary 时不经过简悦自己的图片服务器，解决了内网图片或某些有防盗链的图片无法上传的问题，关联 因 Notion 图床 API 异常导致无法使用的汇总 #5917 内网图片无法上传到 Cloudinary 图床 #5996 关于少数派图片上传到图床的使用疑问 #6550

• Fix 导入图片如果是 http: 形式在 Notion 无法显示的问题，关联 HTTP 图片链接使用 Cloudinary 导出到 Notion 无法显示的问题 #6111 Notion 使用 Cloudinary 图床保存成功后因 HTTP 导致 Notion 无法显示图片（个例） #6171

1.1.2

• Fix因 Notion 版本升级私有 API 变更导致无法使用的问题，细节请看 #6565

1.1.1

• Fix 因图片含有特殊字符导致 Cloudinary 上传成功了但没有正确替换的错误。

1.1.0

• Add Cloudinary 图床方案

1.0.3

• Optimize 导入到 Notion 导入时 url 逻辑。

1.0.2

• Fix 当加入稍后读并且修改稍后读标题后仍按照原标题保存的错误。 #4986

1.0.1

• Fixed 未授权任何 Page 时提示需要先授权

  

• Optimize 已授权 Notion Page 显示

  

• Optimize 当选择导入的是 Page 时，显示原文地址

  

1.0.0

1. 授权并获取 Notion 的空间与页面

2. 导入正文到 Notion

3. 选择任意 Page 导入

[Kenshin]

如需讨论请前往 #4954