작동 원리 및 구조
입력 텍스트를 안전하지 않은 커스텀 JS 태그가 비활성화된 엄격한 `js-yaml` 스키마, 네이티브 `JSON.parse`, 또는 `smol-toml`(TOML v1.0.0 호환)을 통해 중간 JavaScript AST로 파싱한 뒤 원하는 들여쓰기 간격으로 대상 포맷에 맞춰 깔끔하게 직렬화합니다.
단계별 사용 방법
입력 형식(`YAML`, `JSON`, `TOML`)과 목표 출력 형식을 선택합니다.
`docker-compose.yml`, `package.json`, `pyproject.toml` 같은 설정 파일을 붙여넣거나 끌어다 놓습니다.
JSON/YAML 들여쓰기(`2` 또는 `4` 공백)와 선택적 알파벳순 키 정렬 옵션을 설정합니다.
줄 번호가 포함된 구조화된 유효성 오류 메시지를 확인하거나 변환된 설정을 복사·다운로드합니다.
주요 기능 및 장점
- 완벽한 3×3 변환 매트릭스: YAML ↔ JSON ↔ TOML 상호 변환 및 동일 포맷 정렬(Pretty-print) 지원
- YAML 안전 스키마 적용: 임의의 코드 실행이나 위험한 JS 태그를 절대 평가하지 않습니다
- TOML 1.0 완벽 지원: 테이블, 테이블 배열, 인라인 테이블, ISO 날짜 규격 처리
- 최상위 루트 테이블 가드: 루트 테이블이 필수인 TOML로 최상위 배열을 내보낼 때 조용히 깨지지 않고 명확히 안내
- 텔레메트리 제로: 쿠버네티스 시크릿 템플릿이나 CI 워크플로우도 안심하고 검사 가능
계산 방식, 공식 및 기술 표준
YAML 파싱은 `js-yaml` 코어 스키마(`YAML 1.2` 부분집합), JSON은 ECMAScript `JSON.parse`/`stringify`, TOML은 TOML `v1.0.0`을 구현한 `smol-toml`을 사용합니다. TOML 명세상 최상위 문서는 반드시 키-값 테이블이어야 하므로 루트 배열을 TOML로 변환할 때는 객체 래퍼를 요구하거나 오류를 명확히 표시해 잘못된 출력 생성을 방지합니다.
실제 활용 사례
- Node.js/TypeScript `tsconfig.json` 조각을 YAML CI 파이프라인 문법으로 옮기거나 반대로 변환할 때
- Kubernetes 매니페스트나 GitHub Actions `.yml` 워크플로우의 들여쓰기 실수를 빠르게 디버깅할 때
- Rust `Cargo.toml` 또는 Python `pyproject.toml` 의존성 구조를 읽기 쉬운 JSON으로 확인할 때
- 한 줄로 압축(Minify)된 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 주석은 제거됩니다.
- • JSON으로 변환 시 TOML의 로컬 날짜/시간 타입은 ISO-8601 문자열로 직렬화됩니다.
- • JSON/코어 스키마 범위를 벗어나는 YAML 커스텀 앵커나 태그는 보안을 위해 평탄화되거나 거부됩니다.
브라우저 로컬 처리 및 개인정보 보호
일반 웹 변환기는 문서나 미디어 파일을 원격 서버에 업로드합니다. YAML · JSON · TOML 3방향 변환기 & 검증기 도구는 현재 브라우저 탭 내부에서만 실행됩니다:
입력 텍스트와 파일은 외부 서버로 전송되지 않고 기기 내에서 로컬로 계산됩니다.
도구에 붙여넣은 파일이나 데이터를 서버에 기록하거나 저장하지 않습니다.
작업 결과는 브라우저 탭 메모리에만 유지되며 탭을 닫거나 초기화하면 즉시 해제됩니다.
자주 묻는 질문 (FAQ)
YAML을 JSON으로 바꿨다가 다시 돌아오면 주석(#)이 사라지는 이유는 무엇인가요?
표준 JSON 문법은 주석을 지원하지 않기 때문에 중간 AST 변환 과정을 거치면 `#` 주석 줄이 유지되지 않고 제거됩니다.
[1, 2, 3] 같은 JSON 배열을 왜 TOML로 바로 변환할 수 없나요?
TOML 공식 명세상 루트 문서는 항상 키-값 쌍을 가지는 테이블(객체)이어야 하기 때문입니다. `items: [1, 2, 3]`처럼 객체 키 안에 배열을 담아 변환해 주세요.
외부에서 받은 출처 불명의 YAML 파일을 여기서 파싱해도 안전한가요?
네. 위험한 커스텀 JavaScript 실행 태그(`!!js/function` 등)는 절대 활성화되지 않으며 모든 연산이 브라우저 샌드박스 내에서 격리 실행됩니다.
같은 포맷끼리 정렬(예: 압축된 JSON을 보기 좋게 포맷팅)하는 것도 지원하나요?
네, 입력과 출력 형식을 동일하게 선택하면 문법 검증과 함께 원하는 들여쓰기 간격으로 깔끔하게 재정렬해 줍니다.