TOML to 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을 입력하거나 붙여넣으세요. 'Load example'을 클릭해 실제 Cargo.toml, pyproject.toml, 배포 설정을 시험해 볼 수도 있습니다.

2. 2

   실시간 JSON 출력 보기

   출력 패널에 JSON이 즉시 나타납니다. 대상 형식에 맞춰 들여쓰기(Indent) 옵션(2칸 또는 4칸)을 조정하세요. 날짜, 테이블, 테이블 배열은 자동으로 처리됩니다.

3. 3

   복사 또는 다운로드

   Copy를 클릭해 JSON을 클립보드에 담거나, Download를 클릭해 프로그램, 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 라이브러리로 파싱됩니다. 중첩 테이블, 점 표기 키, 인라인 테이블, 테이블 배열, 여러 줄 문자열, 네 가지 날짜-시간 타입을 모두 정확히 처리하며, 파싱 오류를 줄과 열 위치와 함께 보고합니다.

무손실 날짜-시간 및 안전한 정수 처리

TOML 날짜-시간은 정확한 종류(오프셋 date-time, 로컬 date-time, 로컬 date, 로컬 time)를 보존하는 JSON 문자열로 직렬화됩니다. JavaScript의 안전 범위(2^53 - 1)를 넘는 정수는 파싱 중 BigInt로 승격된 다음 정밀도 경고와 함께 가장 가까운 JSON 숫자로 변환되므로, 유효한 TOML이 변환에 실패하는 일이 없습니다.

100% 브라우저 기반 — 업로드 없음, 서버 없음

모든 처리가 브라우저의 JavaScript 엔진에서 이루어집니다. 어떤 시점에도 데이터가 전송되지 않습니다. 200KB보다 큰 입력은 인터페이스 반응성을 유지하기 위해 실시간에서 수동 모드(명시적 Convert 클릭)로 전환됩니다.

모범 사례

매우 큰 정수는 문자열로 저장하기

TOML에 2^53 - 1을 넘는 정수(Snowflake ID, 나노초 타임스탬프, 큰 카운터)가 있으면 변환 전에 따옴표로 감싸 문자열로 만드세요. 브라우저의 JSON 숫자는 이를 정확히 담을 수 없으며, 반올림해야 할 때 도구가 경고합니다.

JSON 출력에는 2칸 들여쓰기 선호하기

두 칸 들여쓰기는 JSON에서 가장 널리 쓰이는 관례이며, 대부분의 포매터와 비교 도구와 잘 어울리는 깔끔하고 읽기 쉬운 출력을 만듭니다. 4칸 들여쓰기는 스타일 가이드가 요구할 때를 위해 남겨 두세요.

사용하기 전에 JSON 출력 검증하기

변환 후 JSON을 손으로 편집하거나 엄격한 곳에 넣을 계획이라면 JSON 포매터에 통과시켜 유효하고 일관되게 형식화되었는지 확인하세요.

TOML 주석은 따로 보관하기

JSON에는 주석 문법이 없으므로 TOML의 # 주석은 변환 시 삭제됩니다. 주석이 중요한 문서라면 생성된 JSON과 함께 버전 관리에 원래 TOML을 보관하세요.

반복되는 섹션에는 테이블 배열 사용하기

유사한 섹션이 여러 개(서버, 리다이렉트, 바이너리) 있을 때는 [section]을 반복하기보다 테이블 배열([[section]])로 작성하세요. 중복 테이블 오류를 일으키는 대신 깔끔한 객체의 JSON 배열로 변환됩니다.

자주 묻는 질문