发布Notion到GitHub Pages

type

status

date

summary

category

icon

中间隔了个几年没有使用Hexo写文章了，前几月想再次尝试，写了几篇后发现还没有没有啥写的欲望。主要一个原因是不太习惯使用Markdown写作了。现在各种富文本的笔记软件，例如Notion、飞书、语雀、甚至印象笔记的也还不错，再回到写Markdown，实在有些别扭，图片、格式等需要单独开一个预览窗口查看，甚是难受。

目前Notion甚是火，恰好搞一个Notion的教育优惠，以后就准备使用Notion写写文章啥的了。但Notion做为一个笔记软件，目前分享太单一，结合Hexo思路，搜了下，确实有方式可以将Notion的文章自动同步到GitHub Pages中，踩了些坑，优化了一些步骤，故重新整理了一下。

展示效果如下，看看是否满足你的口味，看结构，其他元素都可以可定义的：

虽然我搞了个把小时，但相信各位都比我聪明，应该10min内就能搞定的。

Notion 侧的改造

Notion文章转换为GitHub Pages是基于Notablog实现，Notablog对数据格式是有要求的，必须是Notion table，因此所有文章都需要在一个table中进行管理，下述截图就是我的GitHub Pages对应的Notion table：

注意：这个Table是有一个格式要求，正确的创建方式是，打开 Notion table template，然后点击Duplicate 复制这个模板：

然后可以随意修改你们的内容，但表格这几个字段最好别随意修改。例如可以修改Notion table的名称，背景图，文档描述。修改好之后，还有一个关键的一步，需要将这个table 『公开』，这样其他人才可以访问内容，包括GitHub。具体操作为，点击右上角的 Share ：

然后可以看到一个公开的地址，下面GitHub配置修改url会用到这个地址。

GitHub 配置

GitHub就比较复杂一些了，需要新建一个仓库，然后通过GitHub Action 来执行代码库的代码，从而拉取Notion上面的数据，并构建为html文件，最后部署到 GitHub Pages中。

Fork 一下我的代码仓库 https://github.com/tiodot/notablog-starter-github-pages 我的配置都调教好了，只需要改动一丢丢。当然看不上的我的也可以从官方推荐的 https://github.com/dragonman225/notablog-starter fork一下，但改动可能得较多些。