先说人话:这个插件到底在干嘛?
一句话:你在 Notion 写文章,它自动帮你发到 WordPress,还会持续同步更新。
我把流程拆成 7 步,下面看图就能明白。
第 1 步:先把配置填好(只做一次)
- Notion:Token + 数据库/数据源 ID
- WordPress:用户名 + 应用密码
- 后台保存后写入 .env
第 2 步:触发同步
你可以手动点按钮,也可以定时自动跑,本质是同一个同步任务。
第 3 步:插件读取 Notion 每一行
会读取 Name、Status、分类、标签、Flag,还有有没有 WP Post ID。
第 4 步:按 Status 决定动作
- Published 且 WP Post ID 为空:创建新文章
- Published 且有 WP Post ID:更新已有文章
- Archived:把对应文章移到回收站
- Draft:跳过,不同步
第 5 步:真正发布内容
正文会自动转换,图片自动传到 WordPress 媒体库,分类标签也一起同步。
注意:Flag 会和 Tags 合并,避免重复标签。
第 6 步:回写结果到 Notion
同步成功后会回写 WP Post ID、WP URL、Last Synced,方便你追踪。
第 7 步:自动巡检(可选)
开启 AUTO_SCAN_INTERVAL_MINUTES 后会定时跑。开启 PRUNE_MISSING_PAGES=true 后,Notion 删除的记录会同步下线到 WP。
最后记住一句:Notion 负责写,WordPress 负责展示,插件负责自动对齐。









