關於 YAML / JSON / TOML 轉換器
「YAML / JSON / TOML 轉換器」是一款實用的線上工具，能夠直接在你的瀏覽器中，將結構化數據在 YAML、JSON 和 TOML 格式之間進行互相轉換。你只需將數據貼入輸入區域，選擇所需的輸入與輸出格式，工具便會即時處理並在輸出區域顯示轉換後的數據。此外，本工具還允許你調整輸出內容的縮排空格。
不論是處理 API 片段的開發人員、調整應用程式設定的用戶、管理 CI/CD 或部署設定的工程師，還是首次接觸設定格式轉換的開發者，此工具都能提供協助。對於需要反覆遷移或整理設定的工程師，以及需要在流動裝置上快速查看或複製結構化數據片段的用戶，這也是一個高效的解決方案。
輸入與輸出設定
在使用此工具時，你可以自由設定以下輸入與輸出參數：
- 輸入格式：可選擇 YAML、JSON 或 TOML。
- 輸出格式：可選擇 YAML、JSON 或 TOML。
- 輸入：於標示為「貼上 YAML、JSON 或 TOML...」的輸入欄位中，貼入已選擇輸入格式的結構化數據。
- 縮排：可設定數值來調整縮排，針對 JSON 和 YAML 支援 2 個或 4 個空格。
轉換成功後，工具會提供以下輸出資訊：
- 輸出：轉換後的結構化數據會顯示在「轉換結果會顯示在這裡。」的欄位中。
- 輸入字數：顯示輸入數據的字元總數。
- 輸出字數：顯示輸出數據的字元總數。
- 頂層：提供關於數據根元素（Root element）的資訊。
- 項目：顯示數據中的項目總數。
轉換規則與限制
為了確保數據正確轉換，請留意以下規則與系統限制：
- 註解與間距：輸入數據中的原始註解和原始間距在轉換後將不會被保留。
- TOML 限制：TOML 輸出格式必須包含頂層表（Top-level table）。單獨的字串、數字或陣列無法寫成有效的 TOML 文件。
- 字數限制：輸入內容必須限制在 2,000,000 個字元以內。
錯誤提示與狀態說明
在操作過程中，工具會根據不同情況顯示對應的提示訊息：
- 請先貼上一些輸入。：當輸入欄位為空時顯示。
- 請選擇兩個不同的格式。：當選擇的輸入格式與輸出格式相同時顯示。
- 輸入內容太大，請控制在
{max}個字元以內。：當輸入內容超過 2,000,000 個字元時顯示。 - 這個 JSON 無法解析。：當 JSON 輸入數據解析失敗時顯示。
- 這個 YAML 無法解析。：當 YAML 輸入數據解析失敗時顯示。
- 這個 TOML 無法解析。：當 TOML 輸入數據解析失敗時顯示。
- 這份數據無法寫成有效的 TOML。：當數據結構無法寫成有效的 TOML 文件時顯示。
- 這次轉換耗時太久，請換一段更小的輸入。：當轉換處理時間過長時顯示。
- 無法轉換這段輸入。：當轉換因其他原因失敗時顯示。
- 輸入和輸出已清空。：當清除輸入與輸出內容時顯示。
- 範例已填入。：當載入範例數據時顯示。
- 格式已交換。：當交換輸入與輸出格式時顯示。
- 已開始下載。：當開始下載轉換結果時顯示。
- 已將
{from}轉換為{to}。輸出大小：{size}。：當轉換成功後顯示。
瀏覽器本機隱私保護
你的 YAML、JSON 和 TOML 數據均會在你的瀏覽器本機進行轉換。整個處理過程不會上傳任何數據到 BroBroGo，保障你的數據隱私。
常見問題 FAQ
支援哪些轉換？
YAML、JSON 和 TOML 可以任意互轉。轉換前先選擇輸入格式和輸出格式即可。
為什麼有些值不能轉成 TOML？
TOML 檔需要頂層表。單獨的字串、數字或陣列可以轉成 JSON 或 YAML，但不能寫成有效的 TOML 文件。
註解會保留嗎？
不會。轉換器會讀取數據值並寫出一份乾淨的新文件，原本的註解和排版不會一起帶過去。