📧 電子報發送指南
這是使用 Markdown + CLI 發送電子報的快速指南。 目前發送平台為 ConvertKit（Kit）。
1. 撰寫內容
編輯目錄下的 template.md（或複製成新檔案）。
Frontmatter 設定：
---
title: 2026年X月電子報 # 內部識別用
subject: 【懶】電子報主旨 # 收件者看到的標題
description: 預覽文字 # 收件匣預覽
send_at: 2026-02-15T10:00:00+08:00 # 排程發送時間
# campaign, issue_number 會自動生成，無需填寫
---
2. 常用指令
在專案根目錄執行：
🔍 本地預覽 (Preview)
生成 preview.html 並在瀏覽器查看：
python3 -m scripts.newsletter_automation.main preview content/newsletter/template.md
🧪 測試發送 (Test)
只發送給 tester tag 確認排版：
python3 -m scripts.newsletter_automation.main send content/newsletter/template.md --test
🚀 正式發送 (Send)
發送給所有訂閱者（依照 send_at 時間）：
python3 -m scripts.newsletter_automation.main send content/newsletter/template.md
📜 查看記錄 (Logs)
python3 -m scripts.newsletter_automation.main logs
3. 功能說明
- 自動樣式：自動套用 Kit 模板 (Header/CTA/Footer)。
- 自動 UTM：連結自動加上
utm_campaign,utm_content。 - Notion 備份：發送後自動備份至 Notion Database。
4. 發送前檢查
確認生效路徑沒有舊平台字串殘留：
pnpm run check:newsletter:provider