底層運作原理
輸入文字會依來源格式分別交由嚴格的 `js-yaml` 核心 Schema 規則(停用危險的自訂 JS 標籤)、瀏覽器原生 `JSON.parse` 或符合 TOML v1.0.0 規範的 `smol-toml` 解析為中介 JavaScript AST,驗證無誤後再依指定縮排乾淨序列化輸出為目標格式。
詳細操作步驟
分別選擇您的「輸入格式(YAML、JSON 或 TOML)」與「目標輸出格式」。
貼上或拖曳放入設定檔(例如 `docker-compose.yml`、`package.json` 或 `pyproject.toml`)。
選擇 JSON/YAML 的縮排空格數(2 或 4 空格)以及是否依字母順序排序鍵名。
檢視附帶精確行號的結構化驗證錯誤提示,或一鍵複製/下載轉換後的設定檔。
核心功能與效能優勢
- 完整 3×3 轉換矩陣:自由在 YAML ↔ JSON ↔ TOML 之間互轉,亦支援同格式美化縮排
- 採用 YAML 安全 Schema:絕不執行任意程式碼或危險的自訂 JS Tag
- 完整支援 TOML 1.0:涵蓋資料表(Tables)、資料表陣列、行內表格與 ISO 日期格式
- TOML 根陣列防呆保護:當 JSON 根層級為純陣列或純量值時明確提示,避免產生不合法的 TOML
- 零遙測紀錄:Kubernetes 密鑰範本與 CI/CD 敏感工作流設定也能安心貼入
運算方法、公式與技術標準
YAML 解析基於 `js-yaml` 核心 Schema(`YAML 1.2` 子集);JSON 採用 ECMAScript 原生 `JSON.parse`/`stringify`;TOML 則採用實作 `v1.0.0` 規範的 `smol-toml`。由於 TOML 規範要求根節點必須是鍵值對資料表,因此將根陣列轉換為 TOML 時系統會明確拒絶並提示需包覆於物件鍵名下,而非靜默產生毀損輸出。
常見實務應用情境
- 將 Node.js/TypeScript 的 `tsconfig.json` 片段遷移到 YAML CI 管線設定,或反向轉換
- 快速排查 Kubernetes YAML 清單或 GitHub Actions `.yml` 工作流中的縮排層級錯誤
- 把 Rust `Cargo.toml` 或 Python `pyproject.toml` 相依套件設定轉成易讀的 JSON 結構檢查
- 將壓縮成單行的 JSON 酬載快速展開格式化為人類易讀的 YAML
實作範例與邊界案例
TOML to YAML
[server]\nhost = "127.0.0.1"\nport = 8080
server:\n host: 127.0.0.1\n port: 8080
Nested TOML tables map directly to indented YAML mappings.
Root Array Notice for TOML
["alpha", "beta"]
Error: TOML requires a top-level object/table (cannot serialize a bare root array).
Prevents invalid TOML output per TOML v1.0.0 specification.
使用限制與精準度說明
- • 由於標準 JSON 語法不支援註解,經由中介 AST 轉換時原始 YAML 或 TOML 中的 `# ...` 註解行會被移除。
- • TOML 的本地日期/時間型別在轉換為 JSON 時會序列化為 ISO-8601 字串。
- • 基於安全考量,超出 JSON/Core Schema 規範的自訂 YAML Anchor 標籤會被扁平化或拒絕解析。
瀏覽器本地運算與隱私保障
傳統線上轉換網站會將您的文件、文字片段或影音檔案上傳至遠端伺服器。YAML、JSON 與 TOML 三向互轉與驗證工作台 完全在您的瀏覽器分頁內運行:
您的檔案與文字都在裝置本機計算,不會傳送內容至任何後端伺服器。
Microdeck 不會記錄或儲存您在工具內貼上的任何檔案或程式碼。
所有暫存結果僅存在目前分頁記憶體中,重設或關閉分頁後即刻清除。
常見問題 (FAQ)
為什麼把 YAML 轉成 JSON 再轉回來之後,原本的 `#` 註解都不見了?
因為標準 JSON 規範本身不支援註解語法,所以任何經過共通結構化 AST 中介層的格式轉換都會移除 `#` 註解文字。
為什麼像 [1, 2, 3] 這樣的 JSON 陣列沒辦法直接轉成 TOML?
根據 TOML 官方規範,根文件最外層必須永遠是一個資料表(鍵值對物件)。請先將陣列包進一個物件鍵名中,例如 `{ "items": [1, 2, 3] }` 再進行轉換。
在這裡貼上來路不明的 YAML 檔案解析安全嗎?
非常安全。本工具絕不啟用自訂 JavaScript 執行標籤(如 `!!js/function`),且所有解析作業完全隔離在您的瀏覽器沙盒環境中運行。
支援同格式的語法檢查與縮排美化嗎(例如 JSON 轉格式化 JSON)?
支援!只要將來源與目標設為相同格式,系統就會幫您驗證語法正確性並重新整理縮排。