Notion的Integration主要为开发者提供的功能,旨在方便第三方应用通过notion api直接访问Notion的文档,因此
Secret key
非常重要请勿泄露。
Markdown Nice
没有服务端,所有请求都是通过浏览器发送,不会保存用户输入的Secret Key
,为了方便用户每次重新输入Key,会在浏览器缓存,下次导入文档的时候不用重新输入Secret Key
,只用输入要导入的页面ID皆可。
如果依然担心Secret Key
泄露被用来读写Notion数据,你可以在导出页面之后取消集成,这样即便其他人拿到了Key也不能对任何页面操作,同样在创建集成的时候建议只授予集成读权限Markdown Nice介绍
Markdown Nice
是一个开源的Markdown编辑器,支持将预览内容一键复制到微信公众号、知乎和掘金等第三方创作平台。笔者基于此添加了Notion的功能,可以将Notion文档转换为Markdown格式,然后进行编辑修改最终复制到公众号等创作平台,源码见https://github.com/KDF5000/markdown-nice同时笔者也部署了一个在线版本,可以直接使用
准备工作
- 注册一个Notion账号,并创建一个Workspace或者加入一个已经存在的workspace
- 确保你对workspace有管理权限
创建一个Integration
Notion的集成可以让你将 Notion 中的信息连接到其他软件中。按照下面的步骤创建自己的集成,请按照以下步骤进行操作:
- 点击
+ New integration
按钮。
- 输入名字,选择需要的workspace以及允许的权限
- 点击
Submit
以创建集成。
在下一页中,你将找到 Notion 集成令牌,也称为 API Secret Key,使用该
Secret Key
可以向 Notion API 发出请求。要在离开此页面后检索令牌,请返回 https://www.notion.so/my-integrations 并单击 view integration
分享页面给集成
现在你已经创建了一个集成,需要授权它访问数据库或者页面。为了保证信息的安全性,在工作区中,集成一开始是没有访问任何页面或数据库的。你必须分享特定的页面给一个集成,以便API访问这些页面。分享数据库给你的集成:
- 进入你工作区的数据库页面
- 点击页面右上角的
…
- 在弹出窗口的底部,点击
Add connections
- 在
Search for connections…
菜单中搜索并选择上一章节创建的集成
现在使用该集成的
secret key
就可以访问页面了使用Markdown Nice导入Notion页面
获取到
Secret Key
并且确保已经将要导入的页面分享给集成后,访问https://md.pcursor.run
, 通过文件→导入Notion文档
将页面转换为Markdown格式。导入时候需要输入secret key
和页面ID
- Secret Key: 即前面申请的集成的
Secret Key
- Notion Page ID: 在Notion里打开页面
Share→Share to Web
里链接的最后一部分字符串即为页面ID