寫好第一篇文章

寫好第一篇文章

專案只需安裝一次。建立文章,寫 Markdown 內文,在本機預覽,再發布產生的靜態檔案。

使用 Node.js 22.12 或更新版本。建置輸出 dist/,可部署到 Cloudflare、Vercel、Netlify、騰訊 EdgeOne Pages 與阿里雲 ESA Pages。雜湊 CSS 與 JavaScript 快取一年,HTML 保持可重新驗證。

npm ci
npm run dev

開啟新建命令輸出的檔案。兩道 front matter 分隔線之間保存中繼資料,內文寫在第二道分隔線之後。標題已由文章頁顯示,內文無需再寫同名一級標題。

npm run new -- post "A quiet afternoon"
---
title: A quiet afternoon
date: 2026-10-06
category: blog
---

A story, a picture, and what I noticed.

![By the water](/images/walk.jpg)

用一個 category 表達文章主題。專案頁的 post-list 使用對應分類,見聞只展示 blog 與 uncategorized。標籤用於描述文章,不決定文章出現在哪個列表。

{
  "type": "post-list",
  "title": "Project notes",
  "category": "edgepress",
  "count": 3
}