Microdeck.tools 100% 브라우저 실행

YAML · JSON · TOML 3방향 변환기 & 검증기

New

`Cargo.toml`, `pyproject.toml`, Docker Compose, GitHub Actions, Kubernetes 매니페스트 등 YAML, JSON, TOML 파일을 양방향 변환하고 검증합니다. 엄격한 파서가 중복 키와 스키마 오류를 오프라인에서 잡아냅니다.

100% 브라우저 실행 서버 업로드 없음 즉시 결과 확인

이 도구가 시간을 절약하는 데 도움이 되었나요? Microdeck을 무료로 유지하고 개선하는 데 힘을 보태주세요. 자율 참여 · $3부터.

작동 원리 및 구조

입력 텍스트를 안전하지 않은 커스텀 JS 태그가 비활성화된 엄격한 `js-yaml` 스키마, 네이티브 `JSON.parse`, 또는 `smol-toml`(TOML v1.0.0 호환)을 통해 중간 JavaScript AST로 파싱한 뒤 원하는 들여쓰기 간격으로 대상 포맷에 맞춰 깔끔하게 직렬화합니다.

단계별 사용 방법

1

입력 형식(`YAML`, `JSON`, `TOML`)과 목표 출력 형식을 선택합니다.

2

`docker-compose.yml`, `package.json`, `pyproject.toml` 같은 설정 파일을 붙여넣거나 끌어다 놓습니다.

3

JSON/YAML 들여쓰기(`2` 또는 `4` 공백)와 선택적 알파벳순 키 정렬 옵션을 설정합니다.

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을 보기 좋게 포맷팅)하는 것도 지원하나요?

네, 입력과 출력 형식을 동일하게 선택하면 문법 검증과 함께 원하는 들여쓰기 간격으로 깔끔하게 재정렬해 줍니다.

관련 마이크로 도구 살펴보기

Microdeck 후원하기

100% 자율 후원 · $3부터 · 회원가입 불필요

금액 선택 (USD):선택 금액:$5

최소 후원 금액은 $3 USD입니다.

100% 자율 · $3부터 · Gumroad 안전 결제 창이 열립니다.