用 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

寫作上的幾個習慣

  1. 先寫標題和第一段,哪怕之後會全部改掉。空白頁最難對付。
  2. 一段只講一件事。如果一段裡出現兩個「但是」,通常就該拆開。
  3. 把不確定的地方留成問題,不要用模糊的句子假裝自己懂了。
  4. 寫完之後唸一次。唸不順的地方,讀者也會卡住。

工具只是容器。真正決定文章好壞的,還是坐下來寫的那段時間。