Overview

This integration system allows you to write blog posts directly in Notion and automatically sync them to your website and won't change any existing blog templates or styles!

Workflow

Notion Database → Auto Sync → Markdown Files → Blog HTML → Website Update

Step 1: Create Notion Database

1.1 Create New Database

1. Create a new page in Notion
2. Add a Database
3. Select "Table" view

1.2 Setup Database Fields

Required Fields:

• Title - Title type - Article title
• Status - Select type - Options: 'Draft', 'Published'
• Date - Date type - Publication date

Optional Fields:

• Tags - Multi-select type - Article tags
• Summary - Text type - Article summary

1.3 Database Example

Step 2: Get Notion API Key

2.1 Create Integration

1. Visit Notion Integrations
2. Click "New integration"
3. Fill in the information:
4. Click "Submit"
5. Copy the Internal Integration Token (keep it secret!)

2.2 Connect Database

1. Go back to your Notion database page
2. Click the "..." menu in the top right
3. Select "Add connections"
4. Choose your newly created "Blog Sync" integration

2.3 Get Database ID

1. Open your database in the browser
2. Copy the database ID from the URL (32-character string)

Step 3: Local Setup

3.1 Set Environment Variables

MacOS/Linux: Add to ~/.zshrc or ~/.bash_profile

export NOTION_TOKEN="your_integration_token_here" export NOTION_DATABASE_ID="your_database_id_here"

3.2 Test Sync (For Joyce)

cd blog python3 sync_notion.py

Step 4: GitHub Automation Setup

4.1 Setup GitHub Secrets

1. Visit your GitHub repository
2. Click "Settings" → "Secrets and variables" → "Actions"
3. Click "New repository secret"
4. Add two secrets:

4.2 Auto Sync

GitHub Actions will:

• Automatically check Notion updates daily
• Sync published articles
• Auto build and deploy blog

Step 5: Writing Workflow

5.1 Writing in Notion

1. Create a new row in the database
2. Fill in title, tags, summary
3. Set Status to 'Draft'
4. Write content in the page (supports all Notion formats)

5.2 Publishing Articles

1. After finishing content, change Status to 'Published'
2. Set publication date
3. Wait for auto sync (daily) or trigger manually

5.3 Manual Sync

Local Sync:

cd blog python3 sync_notion.py

GitHub Manual Trigger:

1. Visit GitHub repository
2. Click "Actions" → "Notion Blog Auto-Sync"
3. Click "Run workflow"

Troubleshooting

Common Issues

Q: Sync fails with 401 error A: Check if Integration Token is correct, ensure database is connected Q: No articles found A: Make sure article Status is "Published", verify database ID is correct Q: Article format is wrong A: Check Notion database field names match (Title, Status, Date, Tags, Summary) Q: GitHub Actions fails A: Check if GitHub Secrets are properly set