用 Markdown 寫文章的工作流
從開一個檔案,到文章出現在網站上,中間只有幾個步驟。
這個網站沒有後台。寫文章的方式很原始:開一個 Markdown 檔案,寫完,存檔,部署。
新增一篇文章
在 src/content/blog/ 底下建立檔案,檔名會成為網址的一部分。例如 hello-marsh.md 會變成 /blog/hello-marsh/。
檔案開頭需要一段 frontmatter:
---
title: "文章標題"
description: "一句話描述,會用在列表與 SEO。"
pubDate: 2026-11-05
tags: ["寫作", "Markdown"]
draft: false
---
幾個欄位的規則:
title與description必填。pubDate決定文章在列表中的順序。tags可以是空陣列,會自動產生標籤頁。draft: true的文章只會在開發模式出現,不會進正式建置。
預覽與部署
本機開發:
npm run dev
實際上線前先建置一次,確認型別與內容都沒有問題:
npm run build
如果使用 Cloudflare Workers,部署指令會長這樣:
npm run deploy
寫作上的幾個習慣
- 先寫標題和第一段,哪怕之後會全部改掉。空白頁最難對付。
- 一段只講一件事。如果一段裡出現兩個「但是」,通常就該拆開。
- 把不確定的地方留成問題,不要用模糊的句子假裝自己懂了。
- 寫完之後唸一次。唸不順的地方,讀者也會卡住。
工具只是容器。真正決定文章好壞的,還是坐下來寫的那段時間。