YAML TOML 변환기

사용 방법

1. 1

   YAML 매핑 붙여 넣기

   YAML을 붙여 넣거나 .yaml 파일을 편집기에 끌어다 놓고, 예제 칩을 고를 수도 있습니다. TOML은 최상위가 테이블이어야 하므로 YAML의 루트가 매핑이어야 합니다.

2. 2

   문서를 읽는 방식 정하기

   파일에 문서가 여러 개면 자동 모드는 이를 목록으로 만드는데, TOML은 루트에 목록을 둘 수 없습니다. 첫 문서만을 고르면 첫 문서를 변환하고 나머지에 대한 알림이 나옵니다.

3. 3

   병합 키 설정

   병합 키(<<) 펼치기는 기본으로 켜져 있어 <<: *defaults의 키가 테이블에 복사됩니다. TOML에는 병합 기능이 없으니, "<<" 하위 테이블을 보려는 경우가 아니면 켜 두세요.

4. 4

   알림 읽기

   알림은 빠진 null 값을 경로와 함께 나열하고, 2^53을 넘는 정수나 무한대를 텍스트로 썼을 때도 알려 줍니다. 파일을 쓰기 전에 확인하세요.

5. 5

   복사 또는 저장

   TOML을 복사하거나 config.toml로 내려받습니다. YAML 원본이 표현하지 못하는 TOML 고유의 날짜나 주석은 직접 추가하세요.

작동 원리

실제 예시

title: Demo
owner:
  name: Ada
ports: [8000, 8001]
limits: {cpu: 0.5, mem: 123456}

title = "Demo"
ports = [8000, 8001]

[owner]
name = "Ada"

[limits]
cpu = 0.5
mem = 123456

a: ~
when: 2026-10-01
ratio: 1.0
big: 1e21
name: x
id: 9007199254740993
mixed: [1, two, true]

when = "2026-10-01"
ratio = 1
big = 1e+21
name = "x"
id = "9007199254740993"
mixed = [1, "two", true]

app:
  name: demo
  db:
    host: localhost
    replicas:
      - {host: a, port: 1}
      - {host: b, port: 2}
  empty: []
  none: {}
  mixed: [1, {k: v}, null]

[app]
name = "demo"
empty = []
mixed = [1, { k = "v" }]

[app.db]
host = "localhost"

[[app.db.replicas]]
host = "a"
port = 1

[[app.db.replicas]]
host = "b"
port = 2

[app.none]

base: &b {host: db, port: 5432}
dev:
  <<: *b
  port: 6543

[base]
host = "db"
port = 5432

[dev]
host = "db"
port = 6543

my key: 1
"a.b": 2
nested:
  x-y: 3
  "q\"uote": 4

"my key" = 1
"a.b" = 2

[nested]
x-y = 3
"q\"uote" = 4

- a
- b

루트가 매핑(key: value 쌍)이어야 합니다. 목록이나 여러 문서는 쓸 수 없습니다.

자주 하는 실수

• null이 출력에서 사라짐

  ~나 null은 모두 빠지므로, null이던 키가 TOML에는 없고 읽는 쪽에서는 설정되지 않은 것으로 볼 수 있습니다. 결과 아래 알림에 경로가 나오니, 키가 꼭 있어야 하면 빈 문자열 같은 다른 값으로 바꾸세요.

• 날짜가 TOML 날짜가 아님

  YAML 날짜와 타임스탬프는 문자열로 읽혀 "2026-10-01"로 쓰입니다. 받는 쪽이 TOML 날짜 타입을 기대하면 따옴표를 직접 지우세요.

• 주석과 앵커는 사라짐

  TOML은 데이터에서 만들어지므로 YAML 주석이 넘어가지 않고, 앵커와 별칭은 반복된 복사본이 됩니다. 주석이 중요하면 YAML을 원본으로 보관하세요.

• 최상위 목록이나 여러 문서

  TOML은 루트에 목록을 둘 수 없어 변환이 오류로 멈춥니다. 목록을 키 아래로 옮기거나, 여러 문서 입력에서는 첫 문서만을 고르세요.

• 정수 값 실수는 소수점이 사라짐

  ratio: 1.0은 정수 ratio = 1로 쓰입니다. 받는 쪽이 꼭 실수를 요구하면 변환 뒤에 1.0으로 고치세요.

• 키 순서는 자바스크립트 객체를 따름

  1처럼 정수 모양인 키는 맨 앞에 쓰입니다. 나머지 키는 YAML 순서를 유지하지만 스칼라는 항상 하위 테이블보다 앞에 옵니다.

자주 묻는 질문