# YAML 格式化工具

URL: https://tools.otaku-dojo.com/zh-tw/yaml-formatter
Updated: 2026-10-03

YAML 格式化工具會檢查 YAML 語法、標出錯誤的行號與欄位，並以統一的縮排重新輸出；也能一鍵把 YAML 轉成 JSON，或把 JSON 轉成 YAML。常用在檢查 Docker Compose、Kubernetes 與 CI 設定檔，全部在瀏覽器內處理。

## 如何使用YAML 格式化工具

1. 選擇模式：「整理 YAML」、「YAML → JSON」或「JSON → YAML」。
2. 把內容貼到左側輸入框，或按「範例」載入 Docker Compose 範例。
3. 右側即時顯示結果；語法錯誤時，狀態列會指出錯誤的行與欄。
4. 按「複製」或「下載」取得結果。

## 規格與重點

- **支援規格**: YAML 1.2（使用 js-yaml 4.3）
- **轉換方向**: 整理 YAML、YAML → JSON、JSON → YAML
- **縮排選項**: 2 空格、4 空格
- **錯誤定位**: 顯示錯誤的行號與欄位
- **處理位置**: 你的瀏覽器（資料不會上傳）
- **費用**: 免費、免註冊

## 範例: YAML 轉 JSON

```yaml
services:
  web:
    image: nginx:1.27
    ports:
      - "80:80"
```

→

```json
{
  "services": {
    "web": {
      "image": "nginx:1.27",
      "ports": [
        "80:80"
      ]
    }
  }
}
```

## 常見問題

### YAML 和 JSON 有什麼不同？

YAML 用縮排表示結構、支援註解，較適合人工編輯的設定檔；JSON 用大括號與中括號，格式嚴格，較適合程式之間交換資料。YAML 1.2 是 JSON 的超集合，所有合法 JSON 都是合法 YAML。

### 轉換後註解會不見嗎？

會。YAML 轉 JSON 或重新整理 YAML 時，註解不屬於資料內容，因此不會保留。

### 可以驗證 Kubernetes 或 Docker Compose 檔案嗎？

可以驗證 YAML 語法是否正確，但不會檢查 Kubernetes 或 Compose 的欄位名稱與值是否符合規範。

### 一個檔案有多份文件（---）可以嗎？

目前只處理第一份文件。多份文件請分開貼上。