도구 도움말
YAML ↔ JSON 사용법과 주의사항
YAML ↔ JSON 변환은 같은 설정 데이터를 JSON과 YAML 형식 사이에서 바꾸는 양방향 도구입니다.
변환 방향을 먼저 고른 뒤 텍스트를 붙여넣거나 파일을 열 수 있으며, 결과는 현재 화면에서만 유지됩니다.
언제 쓰면 좋은가
- JSON 예제를 YAML 기반 설정 파일에 옮길 때
- YAML 설정을 프로그램에서 읽기 쉬운 JSON으로 확인할 때
- .json, .yaml, .yml 파일의 데이터 구조를 다른 형식으로 비교할 때
- 설정 조각을 변환한 뒤 코드 리뷰용으로 복사할 때
사용 방법
- JSON → YAML 또는 YAML → JSON 변환 방향을 선택합니다.
- 설정 텍스트를 붙여넣거나 로컬 파일을 불러옵니다.
- 변환 버튼을 눌러 문법 검사와 형식 전환을 실행합니다.
- 오류가 없다면 결과를 검토하고 복사합니다.
사용 팁
- 파일 확장자가 .yaml 또는 .yml이면 YAML → JSON 방향으로 자동 전환됩니다.
- 환경 변수 값이나 비밀 키가 포함된 설정은 결과를 공유하기 전에 제거하세요.
- 변환 후 숫자, 불리언, null 값이 예상한 타입으로 유지됐는지 확인하세요.
주의사항
- 입력 텍스트와 파일은 최대 512KB까지 처리합니다.
- 형식을 다시 생성하므로 YAML 주석, 원래의 줄바꿈, 따옴표 스타일은 보존되지 않습니다.
- 앵커, 별칭, 사용자 정의 태그가 많은 YAML은 변환 결과를 별도로 검토해야 합니다.
자주 묻는 질문
- YAML 주석도 JSON에 남나요?
- 아니요. JSON에는 YAML 주석을 대응해 저장할 표준 필드가 없으므로 변환 과정에서 주석은 유지되지 않습니다.
- 파일 내용이 외부로 전송되나요?
- 이 도구는 선택한 설정 파일을 브라우저 안에서 읽습니다. 결과는 자동 저장하지 않지만, 민감한 값은 직접 보호해야 합니다.
- 어떤 파일 확장자를 열 수 있나요?
- .json, .yaml, .yml과 일반 텍스트 파일을 선택할 수 있습니다. 실제 변환 가능 여부는 파일 내용의 문법으로 판단합니다.