跳至主要内容

之後我要怎麼新增文章

· 閱讀時間約 1 分鐘
Ray（沈睿晉）
Ray（沈睿晉）
大學生、屏東里港救護義消（EMT），也寫 Python / Node.js 做實用工具

這個 blog 的日常操作流程非常簡單，而且不管你今天想寫的是長文還是短記都適用。

1. 在 blog/ 新增文章檔​

檔名可以用日期開頭，方便排序：

blog/2026-06-15-my-topic.md

Front matter 最少保留這些欄位：

---
slug: my-topic
title: 我的主題
authors: [ray]
tags: [notes]
---

2. 決定今天要寫長文還是短記​

如果今天是比較完整的內容，可以用完整模板。

如果今天只是想先記一段想法、觀察或一個問題，也可以直接用短記模板。

兩者都可以用 .md，不用每次都寫得很重。

3. 內容用 Markdown 就夠​

一般文章直接用 .md。

如果你需要：

  • 嵌入 React 元件
  • 客製區塊排版
  • 顯示更複雜的互動內容

再改用 .mdx 就可以。

4. 本機確認 build​

npm run build

只要這一步過了，通常 Cloudflare Pages 也會順利發布。

5. push 到 GitHub​

Pages 會從 repo 自動抓更新並重新部署，這樣整個 blog 就完成一次發文。