jekyll-notion

Import notion pages to a jekyll collection.

Installation

Use gem to install.

$ gem install 'jekyll-notion'

Or add it to the Gemfile.

# Gemfile
gem 'jekyll-notion'

And update your jekyll plugins property in _config.yml.

plugins:
  - jekyll-notion

Setup

Before using the gem create an integration and generate a secret token. Check notion getting started guide to learn more.

Export the notion secret token in an environment variable named NOTION_TOKEN.

$ export NOTION_TOKEN=<secret_...>

Once your notion database has been shared, specify the id in your _config.yml as follows.

notion:
  database:
    id: b91d5...
    collection: posts
    filter: { "property": "Published", "checkbox": { "equals": true } }
    sort: { "property": "Last ordered", "direction": "ascending" }
    frontmatter:
      layout: post

The other properties are:

• collection: the collection each page belongs to (posts by default),
• filter: the database query filter,
• sort: the database query sort,
• frontmatter: additional frontmatter to append to each page in the collection.

Note: Only one database is available.

And that's all. Each page in the notion database will be included in the selected collection.

Notion properties

Below, page notion default properties are set in each page frontmatter.

---
id: id
title: properties > Name > title > plain_text
cover: cover > external > url
date: created_time
icon: icon > emoji
---

Any property provided in the frontmatter config that matches a default property will be overwritten by the default value.

Page filename

There are two kinds of collections: posts and others.

When the collection is posts, the filename format contains the created_time property plus the page title as specified in jekyll docs.

YEAR-MONTH-DAY-title.MARKUP

Any other collection, the filename is the page title.