實作文章
非工程背景點管理 Astro 文章？最小內容工作流（可直接套用）
Astro 對內容團隊最常見嘅阻力，往往唔係「技術好難」，
而係每個人都用自己方式寫，發佈時先發現欄位漏填、標題重複、或者格式唔一致。
好消息係：你唔使識寫程式，都可以建立一套寫文 → 檢查 → 交俾同事發佈嘅穩定流程。
先講結論
- 先統一模板，再談寫幾快
- 文章頂部設定（frontmatter）欄位固定，列表頁、分類、搜尋描述先會穩
- 每篇文發佈前必跑檢查清單，唔好靠記憶
- 寫文同發佈可以分開做；一人專心寫，一人專心核對同上線
兩種角色，分工會輕鬆好多
| 角色 | 主要做咩 | 需要識程式嗎 |
|---|---|---|
| 內容同事 | 跟模板寫文、填頂部設定、自查格式 | 唔使 |
| 發佈負責人 | 預覽網站、確認無錯、上傳到 GitHub、觸發 Cloudflare 重新部署 | 跟住 checklist 做就得 |
如果你係一人團隊，兩個角色都係你；但仍然建議分兩個時段：先寫完再檢查，唔好邊寫邊急住上線。
最小內容流程（4 步）
第 1 步：複製一篇現成文章當模板
喺你嘅 Astro 專案入面，搵放 blog 文章嘅資料夾（通常係 src/content/blog/）。
複製一篇已經上線、格式正常嘅 .md 或 .mdx 檔，改個新檔名（例如用英文 slug，方便網址）。
跟住先改文章最頂嗰段設定，再寫正文；次序唔可以反，否則好易忘記改標題或日期。
第 2 步：填好文章頂部設定（frontmatter）
每篇 Markdown 最上面，有一段用 --- 包起嘅設定，就叫做 frontmatter。
你可以當佢係「這篇文章嘅名片」：網站列表、搜尋結果、分類頁都會用呢啲欄位。
最少要填：
title：文章標題（讀者見到嘅主標）description：一句話摘要（搜尋結果下面嗰段字）pubDate：發佈日期（格式例如2026-04-29）category：分類（例如「教學指南」；全站用同一套分類名）
建議教學文再加：
faq：3 至 5 條常見問答（每條有question同answer）heroImage：如有封面圖，填圖片網址同heroImageAlt說明
欄位名同全站保持一致；唔好今篇叫 category、下篇自己發明新名。
第 3 步：按固定骨架寫正文
建議每篇教學文都跟同一結構，讀者同 AI 都易跟：
- 先講結論（3 至 5 點重點）
- 分步驟說明（每步做咩、點樣知做啱）
- 常見錯誤（症狀 → 原因 → 點改）
- 下一步（讀者應該做咩、可以去邊篇延伸閱讀）
正文入面唔好再寫一個同 title 一樣嘅大標題；否則網頁可能出現兩個「第一標題」，對搜尋同閱讀都唔好。
第 4 步：發佈前跑檢查清單
交俾發佈負責人之前，內容同事先自己對一次；發佈人再對第二次。
詳細清單見下面一節。
frontmatter 係乜？用一個例子就明
下面係簡化例子（... 代表你嘅正文）：
---
title: 非工程背景點管理 Astro 文章
description: 用固定模板同檢查清單，減少格式錯誤。
pubDate: 2026-04-29
category: 教學指南
faq:
- question: 一定要識 Git 嗎？
answer: 唔一定，可以分工處理發佈。
---
（正文由這裡開始，唔好再重複寫同一個大標題）如果漏咗 title 或 pubDate，網站**建置（build）**時可能會報錯，部署就會停喺半路。
所以「先填頂部設定，再寫正文」係成本最低嘅習慣。
發佈前檢查清單（建議列印或貼喺 Notion）
內容：
- 標題只出現一次（頂部設定有，正文唔好再寫同名 H1）
- 每個小節有清楚小標，段落唔好過長
- 文內有明確「下一步」或行動建議
- 內部連結打得開，冇死鏈
設定：
-
title/description/pubDate/category已填 - 日期係打算上線嗰日（唔係複製舊文留低嘅日期）
- 如有
faq，每條問答同正文冇矛盾
發佈（由負責人做）：
- 喺本機或 Cursor 內預覽，確認排版正常
- 上傳到 GitHub 後，Cloudflare 部署顯示成功
- 上線後用手機同電腦各開一次文章頁
將呢份清單變成固定流程，而唔係「今次記得、下次唔記得」。
常見錯誤
錯誤 1：直接複製舊文，忘記改頂部設定
- 症狀：新文顯示舊標題、舊日期，或者搜尋結果描述錯
- 原因：趕時間，由正文寫起
- 解法：開檔第一件事就改
title、description、pubDate；改完先寫一個字正文
錯誤 2：一篇文想解決太多問題
- 症狀：文好長但讀完唔知要做咩
- 原因：怕寫得不夠完整
- 解法：一篇只解一個核心問題；其餘用「延伸閱讀」連去第二篇
錯誤 3：每個人用唔同分段習慣
- 症狀：有啲文有 FAQ，有啲冇；有啲文冇「先講結論」
- 原因：冇共用模板
- 解法：指定一篇「標準範例文」，新人只准由呢篇複製
驗收方式（點知流程有效）
- 團隊任一人都可以在 30 分鐘內完成一篇初稿（跟模板）
- 發佈後「格式錯、漏欄位」嘅次數明顯下降
- 出文節奏可預期（例如每週 2 篇），唔係每次上線都救火
咩嘢情況下建議搵人睇一次？
下面呢篇係通用教學；如果你符合其中一兩項，用 30 分鐘診斷對一次現況，通常會快過自己試錯堆砌設定。
- 你跟過文內步驟，仍然困喺同一個錯誤迴圈，而且已經用咗預期以外嘅時間（例如超過一個工作天）。
- 牽涉多個帳戶、DNS、寄信驗證（SPF／DKIM）或幾個服務交界，你想一次過排好優先次序同風險。
- 你想將做法接到實際業務流程（表單、名單、漏斗），而唔止係跟住教學跑通 demo。
常見搜尋問法
如果你係搜尋「Astro 新手內容流程」、「非工程背景點管理 Markdown 文章」、「frontmatter 要填乜先唔會部署失敗」、「AEO 文章骨架點寫」，可以直接對照：
- Astro 寫文一定要識程式嗎？
唔一定；關鍵係固定模板、固定頂部設定、固定發布前檢查清單。 - 點樣減少內容團隊格式混亂？
每篇文都跟同一骨架（結論 → 步驟 → 常見錯誤 → 下一步），先求一致再求快。 - AEO 友善文章應該點寫？
用問題式小標 + 先答後解釋，搜尋引擎同 AI 摘要都更易引用。 - Cursor 幫到內容流程嗎？
幫到，尤其批量檢查欄位、統一語氣、搜尋全站有冇漏改舊字串。
下一步
將你現有文章統一補上 category、建立「發布前檢查」表單，再每月回顧最常填錯嘅欄位先修流程。
想睇 Astro 內容站同 Cloudflare 點一齊落地，可先瀏覽 案例目錄 同 服務範圍。
常見問題 FAQ
一定要懂 Git 先可寫 Astro 內容嗎？
唔一定。先用固定模板寫文，再由一位負責人處理上傳同發佈都可行。
frontmatter 最少要填咩？
最少填 title、description、pubDate；如果你有分類策略，再加 category。
點樣避免文章格式每篇都唔同？
強制使用同一模板與檢查清單，發布前逐項核對即可。
About me
你好，我係阿丸。呢度以數位主權為核心，分享點樣用 AI 幫手整網頁、建立吸客贈品頁、整理內容同上線作品， 目標係幫你用更短時間把內容同網站做成可帶走、可維護嘅自有資產。
我會持續更新可跟做嘅教學、踩坑記錄同流程模板，等你唔使被平台黑盒綁死，亦唔使再由零重複試錯。
同時呢度會多寫一人公司最常遇到嘅訂閱制現實：工具加價、用量隱形成本、平台綁定風險， 同埋點樣用可執行嘅做法，將名單、主站同漏斗慢慢揸返喺自己手度。
你會見到嘅內容包括：支出檢視框架、用量上限與警報、搬遷前準備同主權策略；目標唔係一夜換晒工具， 而係先止血，再建立長期可維護嘅自有資產。
想先攞可跟做模板同檢查清單？
先由免費吸客贈品包開始，將文章做法變成你可即用嘅落地清單，再按需要對照服務範圍安排下一步。
想睇合作模式同交付範圍，可先睇服務與合作方式。