第一篇：這個部落格怎麼用

歡迎。這篇文章本身就是一份範本 —— 想知道格式怎麼寫，直接打開 src/posts/2026-08-17-hello.md 對照著看就好。

檔案怎麼命名

檔名格式固定是 年-月-日-短標題.md，例如：

src/posts/2026-08-17-hello.md

前面的日期會自動變成這篇文章的發表日期，後面的 hello 會變成網址： /posts/hello/。網址部分建議用英文或數字，中文雖然能用，但複製貼上時 會變成一長串亂碼。

上面那段設定是什麼

每篇文章最開頭、兩條 --- 之間的區塊叫 front matter，是這篇文章的設定， 不會顯示在畫面上。可以用的欄位：

欄位	必填	說明
title	是	文章標題
description	否	摘要，會出現在列表與 Google 搜尋結果
tags	否	標籤，可以寫多個
cover	否	封面圖路徑
coverAlt	否	封面圖的替代文字（給看不見圖片的人）
draft	否	寫 true 就不會公開，適合寫到一半的稿子

放圖片

圖片放進 src/images/，然後這樣引用：

需要圖說的時候改用這個寫法：

點一下圖片可以放大 —— 那是 src/assets/js/main.js 裡的 initLightbox() 做的事。

重要：不要直接把手機拍的原圖丟進 src/images/。 原圖動輒 5 MB，網站會變很慢。正確做法是丟進 images-inbox/， 再執行 npm run images 自動壓縮。詳見「發文教學」。

分段與強調

粗體 用兩個星號，斜體 用一個星號，程式碼 用反引號。

1. 有序清單這樣寫
2. 第二點
3. 第三點

• 無序清單用減號
• 就這樣

---

寫好之後存檔，執行 npm run dev 就能在瀏覽器預覽； 確認沒問題再 commit、push，網站幾分鐘後就會自動更新。