hugo-notion

hugo-notion

Write in Notion. Publish with Hugo.

Use Notion as a CMS (Content Management System) for your Hugo site/blog.

hugo-notion is a command line (CLI) tool that syncs your Notion page url to your Hugo site's/blog's content directory.

Installation

hugo-notion is a Ruby gem. Use the gem command to install it

gem install hugo-notion --prerelease

Installing the hugo-notion ruby gem will install the huno command

Usage

First, create a Notion integration, generate a secret and connect that integration to the Notion page https://developers.notion.com/docs/create-a-notion-integration#getting-started

Go to your Hugo site directory and run

NOTION_TOKEN=your_notion_secret huno your_notion_page_url

huno will sync your Notion page and its children pages to the content directory.

If you're yet to move your Hugo pages to Notion, you can use my "blog_content" Notion page as a template https://www.notion.so/blog_content-0f1b55769779411a95df1ee9b4b070c9

To avoid having to provide the notion token and notion page url again and again, create an .env file

echo 'NOTION_TOKEN=your_notion_secret' > .env
echo 'CONTENT_NOTION_URL=your_notion_page_url >> .env'

Tips

To run huno say, every 15 seconds, use the watch command

watch -n15 huno

If you're on MacOS and don't have the watch command installed, you can use Homebrew to install it

brew install watch

Bug Reports

If you'd like to report a bug (if there are any, please do), please create a GitHub issue