文件撰寫指南

核心原則

所有 Blog 文章必須包含 YAML Front Matter：

yaml

---
title: 文章標題
excerpt: "文章摘要，簡述文章重點"
date: YYYY-MM-DD HH:mm:ss+08:00 # 必須加上時區，避免日期偏移
tags: [標籤1, 標籤2] # 可為字串或陣列
categories: 分類名稱
---

根據文件類型選擇適當的結構：

code

# 標題
## 前言（為何寫這篇）
## 核心概念
## 實作說明（含程式碼或圖表）
## 常見問題 / 注意事項
## 總結

code

# 標題
## 前言（解決什麼問題）
## 環境準備 / 前置條件
## 步驟說明（Step by Step）
## 完整範例
## 延伸閱讀

code

# 標題
## 問題背景（為何需要）
## 解決方案概述
## 架構設計（含圖表）
## 優缺點分析（使用表格）
## 適用場景
## 結論

code

# 標題
## 流程概述
## 流程圖（Mermaid）
## 各步驟說明
## 注意事項

mermaid

flowchart TD
    A[開始] --> B{條件判斷}
    B -->|是| C[處理A]
    B -->|否| D[處理B]

mermaid

sequenceDiagram
    participant A as 服務A
    participant B as 服務B
    A->>B: 請求
    B-->>A: 回應

code

┌─────────────────┐
│  元件名稱        │
│  ├── 子項目 A   │
│  └── 子項目 B   │
└─────────────────┘

參考 examples/example.md 作為文件撰寫範本