如何使用YAML 格式化工具
- 選擇模式:「整理 YAML」、「YAML → JSON」或「JSON → YAML」。
- 把內容貼到左側輸入框,或按「範例」載入 Docker Compose 範例。
- 右側即時顯示結果;語法錯誤時,狀態列會指出錯誤的行與欄。
- 按「複製」或「下載」取得結果。
範例
YAML 轉 JSON
services:
web:
image: nginx:1.27
ports:
- "80:80"
{
"services": {
"web": {
"image": "nginx:1.27",
"ports": [
"80:80"
]
}
}
}
YAML 最常見的錯誤
- 用 Tab 縮排:YAML 只接受空白縮排,Tab 會直接報錯。
- 縮排不一致:同一層的鍵必須對齊,多一格或少一格都會改變結構。
- 冒號後面沒空白:
key:value會被當成字串,必須寫成key: value。 - 特殊字元沒加引號:值以
*、&、@開頭或包含:時要加引號。 - yes / no / on / off:在 YAML 1.1 會被解析成布林值,要保留字串請加引號。
規格與重點
| 支援規格 | YAML 1.2(使用 js-yaml 4.3) |
|---|---|
| 轉換方向 | 整理 YAML、YAML → JSON、JSON → YAML |
| 縮排選項 | 2 空格、4 空格 |
| 錯誤定位 | 顯示錯誤的行號與欄位 |
| 處理位置 | 你的瀏覽器(資料不會上傳) |
| 費用 | 免費、免註冊 |
常見問題
YAML 和 JSON 有什麼不同?
YAML 用縮排表示結構、支援註解,較適合人工編輯的設定檔;JSON 用大括號與中括號,格式嚴格,較適合程式之間交換資料。YAML 1.2 是 JSON 的超集合,所有合法 JSON 都是合法 YAML。
轉換後註解會不見嗎?
會。YAML 轉 JSON 或重新整理 YAML 時,註解不屬於資料內容,因此不會保留。
可以驗證 Kubernetes 或 Docker Compose 檔案嗎?
可以驗證 YAML 語法是否正確,但不會檢查 Kubernetes 或 Compose 的欄位名稱與值是否符合規範。
一個檔案有多份文件(---)可以嗎?
目前只處理第一份文件。多份文件請分開貼上。