TOML → JSON 変換ツール

TOML とは何で、なぜ JSON に変換するのか？

// Convert TOML to JSON in Node.js using the smol-toml library
import { parse } from 'smol-toml';

const toml = `
[package]
name = "my-app"
version = "1.0.0"

[dependencies]
serde = { version = "1.0", features = ["derive"] }
`;

const data = parse(toml);
const json = JSON.stringify(data, null, 2);

console.log(json);
// {
//   "package": { "name": "my-app", "version": "1.0.0" },
//   "dependencies": {
//     "serde": { "version": "1.0", "features": ["derive"] }
//   }
// }

主な機能

例

[package]
name = "my-app"
version = "1.0.0"
edition = "2021"
authors = ["Jane Doe <jane@example.com>"]

[dependencies]
serde = { version = "1.0", features = ["derive"] }
tokio = { version = "1", features = ["full"] }

[dev-dependencies]
criterion = "0.5"

[[bin]]
name = "my-app"
path = "src/main.rs"

[build-system]
requires = ["hatchling"]
build-backend = "hatchling.build"

[project]
name = "my-package"
version = "0.3.1"
requires-python = ">=3.10"
dependencies = [
  "requests>=2.31",
  "pydantic>=2.0"
]

[project.optional-dependencies]
dev = ["pytest>=8.0", "ruff>=0.4"]

[tool.ruff]
line-length = 100

[build]
command = "npm run build"
publish = "dist"

[build.environment]
NODE_VERSION = "20"

[[redirects]]
from = "/old-path"
to = "/new-path"
status = 301
force = true

[[headers]]
for = "/*"

[headers.values]
X-Frame-Options = "DENY"

baseURL = "https://example.org"
languageCode = "en-us"
title = "My Hugo Site"
theme = "ananke"

[params]
description = "A static site built with Hugo"
mainSections = ["posts", "docs"]

[[menu.main]]
name = "Blog"
url = "/posts/"
weight = 1

[[menu.main]]
name = "About"
url = "/about/"
weight = 2

edition = "2021"
max_width = 100
hard_tabs = false
tab_spaces = 4
newline_style = "Unix"
use_small_heuristics = "Default"
reorder_imports = true
reorder_modules = true

title = "Deployment Log"
last_deployed = 1979-05-27T07:32:00Z
release_date = 1979-05-27
maintenance_window = 02:00:00

[[servers]]
name = "alpha"
ip = "10.0.0.1"
ports = [8001, 8002]

[[servers]]
name = "beta"
ip = "10.0.0.2"
ports = [9001]

使い方

1. 1

   TOML を貼り付ける

   上の入力欄に TOML を入力または貼り付けます。「例を読み込む」をクリックして、実際の Cargo.toml、pyproject.toml、またはデプロイ設定を試すこともできます。

2. 2

   ライブ JSON 出力を見る

   JSON が出力パネルに即座に表示されます。インデントオプション（2 または 4 スペース）を対象の形式に合わせて調整します。日付、テーブル、テーブルの配列は自動的に処理されます。

3. 3

   コピーまたはダウンロード

   「コピー」をクリックして JSON をクリップボードに取得するか、「ダウンロード」をクリックして、プログラム・API・ツール連携にすぐ使える .json ファイルとして保存します。

TOML でよくある落とし穴

name = my-app

name = "my-app"

name = "a"
name = "b"

name = "a"
alt_name = "b"

released = 2026-7-2

released = 2026-07-02

ports = [8001, 8002

ports = [8001, 8002]

snowflake = 1420070400000000000

snowflake = "1420070400000000000"

[servers]
name = "a"
[servers]
name = "b"

[[servers]]
name = "a"
[[servers]]
name = "b"

よくある使用例

Rust Cargo のメタデータ

Cargo.toml を JSON に変換して、依存関係ダッシュボードを構築したり、クレートのバージョンや機能を監査したり、TOML ではなく JSON を前提とするスクリプトや CI にマニフェストデータを渡したりします。

Python プロジェクト設定

pyproject.toml を JSON に変換して、PEP 621 のプロジェクトメタデータを調べたり、依存関係リストを抽出したり、パッケージング設定をプログラムから読むツールを駆動したりします。

デプロイ設定の検査

netlify.toml、foundry.toml、その他のプラットフォーム設定を JSON に変換して、リダイレクト・ヘッダー・ビルド設定を監査したり、別プラットフォーム向けの同等設定を生成したりします。

設定形式の移行

JSON を好むシステムへ移行するときに TOML アプリ設定を JSON に変換したり、jq のような JSON ツールでさらに変換する前の中間ステップとして使ったりします。

静的サイトの設定

Hugo の config.toml を JSON に変換して、サイト設定を移行したり、環境間で構成を差分比較したり、JSON を裏側に持つ設定 UI を構築したりします。

API とスクリプトの入力

人間が書いた TOML を、REST API・サーバーレス関数・自動化スクリプトが直接消費できる JSON に変換し、読みやすい設定と機械入力を橋渡しします。

技術的な詳細

smol-toml による TOML 1.0.0 解析

TOML はゼロ依存で完全に TOML 1.0.0 準拠のパーサーである smol-toml ライブラリで解析されます。ネストされたテーブル、ドット付きキー、インラインテーブル、テーブルの配列、複数行文字列、および 4 種類すべての日時型を正しく処理し、解析エラーを行と列の位置とともに報告します。

損失のない日時と安全な整数の処理

TOML の日時は、正確な種別（オフセット日時、ローカル日時、ローカル日付、ローカル時刻）を保持する JSON 文字列にシリアライズされます。JavaScript の安全な範囲（2^53 - 1）を超える整数は解析中に BigInt に昇格され、その後、精度警告とともに最も近い JSON 数値に変換されるため、有効な TOML の変換が失敗することはありません。

100% ブラウザベース — アップロードなし、サーバーなし

すべての処理はブラウザの JavaScript エンジン内で行われます。いかなる時点でもデータは送信されません。200KB を超える入力はライブから手動モード（明示的な「変換」クリック）に切り替わり、インターフェースの応答性を保ちます。

ベストプラクティス

非常に大きな整数は文字列として保存する

TOML に 2^53 - 1 を超える整数（Snowflake ID、ナノ秒タイムスタンプ、大きなカウンター）がある場合は、変換前に引用符で囲んで文字列にしてください。ブラウザの JSON 数値ではそれらを正確に保持できず、丸めが必要になるとツールが警告します。

JSON 出力には 2 スペースインデントを推奨

2 スペースのインデントは JSON で最も広く使われる慣習で、ほとんどのフォーマッターや差分ツールとうまく調和する、きれいで読みやすい出力を生みます。4 スペースインデントはスタイルガイドが要求する場合のために取っておきましょう。

使う前に JSON 出力を検証する

変換後、JSON を手で編集したり、厳格な場所に渡したりする予定なら、JSON フォーマッター に通して、有効で一貫した形式であることを確認してください。

TOML のコメントは別に保管する

JSON にはコメント構文がないため、TOML の # コメントは変換時に失われます。コメントが重要なドキュメントである場合は、生成された JSON の隣に元の TOML をバージョン管理に保管してください。

繰り返しセクションにはテーブルの配列を使う

似たセクション（servers、redirects、bins）が複数ある場合は、[section] を繰り返すのではなく、テーブルの配列（[[section]]）として書いてください。重複テーブルエラーを引き起こす代わりに、きれいなオブジェクトの JSON 配列に変換されます。

よくある質問