A starter for using Notion as the CMS for a Netlify-deployed static blog. It is for developers and writers who want to draft in Notion and ship a fast static site, with no CMS server and no hand-written HTML.

<aside> 👉 Start here: duplicate this page (the ••• menu, top-right), then open the README on GitHub and follow Get started below. Setup takes a few minutes and one config file.

</aside>

What's inside


Get started

  1. Duplicate this page into your workspace (the database and this guide come with it).
  2. Get the code: github.com/pkemp-ai/notion-netlify-blog. Use the “Use this template” button, or clone it.
  3. Connect Notion: create an integration at notion.so/my-integrations, copy its token, and add it to your Posts database via ••• → Connections.
  4. Configure: put your token in .env as NOTION_TOKEN, then add your site details and Posts database ID to site.config.json.
  5. Install and deploy: run npm install, then connect the repo to Netlify (publish directory = root, no build command).

That is the one-time setup. After that, publishing is one command: set a post's Status to Published, run node publish.mjs, and push. Netlify redeploys.


Links

<aside> 👇 Example posts. Open one to see how a post is structured, then delete them and write your own.

</aside>

Blog Post CMS (template)

Authoring Guide