添加一个 Notion 小组件。
按照自己的需要设置。

先选一款实用的小组件,在来源页面调整设置,再将生成的 URL 嵌入 Notion 页面。

简要步骤

打开小组件的详情页,调整可用设置,复制专用的 HTTPS 嵌入网址,然后在 Notion 中创建一个 嵌入(Embed) 区块,方法是使用 /embed 命令或区块菜单。粘贴 URL,调整区块大小。小组件仍由原网站提供服务;嵌入不等于安装 Notion 原生功能,也不会建立 Notion 数据库连接。

1. 根据实际任务选一款小组件

从明确需求开始:专注计时器、日期日历或小型参考信息面板。浏览 Saif Saber Studio 小组件目录,打开对应详情页,了解它实际能做什么。在确认一款组件在自己的设备上清晰、实用之前,不必一次加入十多款。

检查来源页面列出的要求。公开时钟不同于要求登录账号或输入外部 API 密钥的小组件。不要把私密令牌或没有限制的密钥放进可分享的嵌入 URL。

2. 复制链接前先调整设置

小组件详情页的控制项与运行中的组件内控制项并不相同。例如,目前的 Pomodoro Timer 详情页 列出了明暗主题、五种尺寸、透明背景、工作与休息时长、循环次数、自动开始和声音选项。计时器本身有 Play/Pause、Reset 和 Skip 控件。调整 Notion 嵌入区块大小不会自动修改计时器的设定时长。

  1. 选择适合目标页面的主题和尺寸。
  2. 只更改自己理解的设置,例如计时器的工作与休息时长。
  3. 使用来源页面支持的复制或分享链接功能;不要认为每款组件都支持相同的 URL 参数。
  4. 在嵌入前先用新浏览器标签页打开复制的链接,检查显示效果。

Pomodoro 源代码目前标明默认工作 25 分钟、短休息 5 分钟,并在四个循环后安排 15 分钟长休息。这些只是产品默认值,并非适合所有人的推荐计划。

3. 将 URL 添加到 Notion Embed 区块

  1. 打开有编辑权限的 Notion 页面,把光标放到需要显示小组件的位置。
  2. 输入 /embed 或通过添加区块菜单选择 嵌入(Embed).
  3. 粘贴小组件专用的 HTTPS URL,并确认嵌入。
  4. 拖动区块的尺寸调整手柄,让控件有足够的空间。再检查窄屏下的同一页面。
  5. 保留指向来源页面的普通文本链接,供无法加载嵌入内容的用户使用。

Notion 的 官方 Embed 文档 介绍了嵌入区块和尺寸调整手柄。并非所有外部网站都允许以框架显示;Notion 也提示,需要外部登录的嵌入内容在桌面或移动应用里无法使用。浏览器预览可用,不代表 Notion 原生应用也支持。

示例:设置专注计时器

尝试一次专注时段。在 Pomodoro 设置页选择工作时长,复制专用链接,将组件嵌入学习页面,并在旁边或下方留一小块任务清单空间。使用组件自己的控件启动计时;结束后写一句话,记录完成的任务。

这个预览只是补充,不能替代文字说明。正式批准前,仍需在浏览器和 Notion 原生环境中检查键盘焦点、尺寸、存储和应用表现。

嵌入区块不能保证什么

Notion 的 Embed(嵌入)区块用于显示外部来源,并不保证离线运行、Notion 数据库同步、跨设备设置同步或不同浏览器配置文件之间的数据持久性。Pomodoro Timer 只将自然结束的专注时段记录到浏览器本地存储。跳过会推进计时器,但不会增加已完成的专注次数或专注分钟数;Focus Scoreboard 只有在两个小组件共享同一存储环境时才能读取记录。已记录的时段不能证明实际工作时长,网站和 Notion 嵌入也可能使用不同的存储。清除站点数据可能会删除共享的专注历史;请先导出备份。

如果框架空白,先直接打开 URL。如果仅在 Notion 之外可用,请检查网站的嵌入政策、外部登录、网络及浏览器环境。如果内容显示却被裁切,请调整尺寸。详细排查可查看 小组件故障排查清单。不要绕过来源网站的安全限制。

了解社交小组件如何应对第三方服务商限制 →

常见问题

嵌入后还能修改小组件吗?

通常可以编辑区块 URL,或返回小组件来源页面更改设置。具体方式取决于组件如何编码选项;不要假定设置会自动同步。

小组件能在 Notion 手机上正常使用吗?

不一定。请分别检查来源和原生应用。外部登录、框架政策和小屏布局可能不同于桌面浏览器。