JSON ↔ YAML 변환기
왼쪽에 JSON 또는 YAML을 입력하고 방향을 고르면 오른쪽에 결과가 바로 나옵니다. 결과로 역변환하거나 복사·저장할 수 있습니다.
JSON을 입력하거나 예시를 불러오세요.
브라우저에서 변환 · UTF-8 파일 최대 1 MiB · 주석·원래 서식은 보존되지 않습니다. YAML 앵커·태그·여러 문서·블록 문자열은 지원하지 않습니다.
바로 쓸 수 있게.
- 바로 보이는 화면입력 위치와 결과 위치를 또렷하게 둡니다.
- 결과 먼저핵심 결과를 앞에 두고, 과정은 필요할 때만 보여줍니다.
- 요구 줄이기가입이나 불필요한 정보 입력 없이 바로 쓰게 합니다.
JSON과 YAML, 설정값을 확인하며 바꾸기
JSON YAML 변환기는 설정 데이터의 표기 형식을 바꾸는 도구입니다. JSON의 중괄호와 대괄호로 표현한 구조를 YAML의 들여쓰기와 목록으로 바꾸거나, YAML을 JSON으로 변환합니다. 파일 이름만 .json에서 .yaml로 고쳐서는 내용이 바뀌지 않습니다.
변환 결과에서는 모양보다 값의 종류를 먼저 확인하세요. 숫자 8080과 문자열 "8080"은 서로 다릅니다. 설정을 읽는 프로그램이 어떤 자료형을 요구하는지에 따라 같은 글자도 다르게 작동합니다.
JSON과 YAML은 어디에 쓰나요?
두 형식 모두 이름과 값을 묶어 데이터를 기록합니다. API의 응답이나 프로그램 설정에서 자주 만납니다. JSON의 객체와 배열은 YAML의 매핑과 목록에 해당합니다. 변환은 표기를 바꾸지만 설정 항목의 뜻까지 검사하지는 않습니다.
- JSON은 객체를 { }, 목록을 [ ]로 표시하고 이름과 문자열에 큰따옴표를 씁니다.
- YAML은 들여쓰기로 포함 관계를, 줄 앞의 -로 목록 항목을 나타냅니다.
- 원래 프로그램이 대상 파일 형식을 지원하는지 먼저 확인하세요.
변환 방향을 고르고 원문을 넣으세요
원본이 JSON이면 JSON → YAML, YAML이면 YAML → JSON을 선택하세요. 내용을 입력하면 결과가 갱신됩니다. 입력 중 괄호나 따옴표가 아직 닫히지 않았다면 오류가 잠시 보일 수 있습니다. 오류 위치를 확인하고 수정한 다음 결과를 복사하거나 저장하세요.
- 직접 붙여 넣거나 UTF-8 파일을 불러올 수 있습니다.
- 예시 넣기로 동작을 확인한 뒤 모두 지우기로 새 작업을 시작하세요.
- 결과로 역변환은 현재 유효한 결과를 원문 칸으로 옮기는 명시적 동작입니다.
같은 설정을 두 형식으로 읽어 보세요
예를 들어 JSON의 {"service":{"port":8080,"enabled":true,"tags":["web","api"]}}는 YAML에서 service 아래 port: 8080, enabled: true, tags 목록 두 항목으로 나타낼 수 있습니다. 줄 수와 따옴표 위치는 달라져도 port는 숫자, enabled는 참·거짓 값, tags는 순서 있는 목록인지 비교하면 구조를 확인할 수 있습니다.
- port: 8080 → 숫자 8080
- enabled: true → 참·거짓 값 true
- tags: 다음의 - web, - api → 목록 두 항목
숫자처럼 보이는 문자열을 구분하세요
문자열은 글자 그대로 읽을 값입니다. 앞자리 0이 필요한 식별자나 숫자처럼 보이는 코드는 따옴표로 감싸야 합니다. YAML 출력에서 따옴표 모양이 바뀔 수 있으므로, 글자 모양보다 값이 어떤 자료형으로 읽히는지 확인하세요.
- code: "0012"는 앞자리 0을 포함한 문자열입니다.
- enabled: true는 참·거짓 값이고 enabled: "true"는 문자열입니다.
- value: null은 빈 값이고 value: "null"은 네 글자 문자열입니다.
YAML 들여쓰기는 데이터 구조입니다
YAML에서 들여쓰기를 바꾸면 값이 속한 위치가 달라집니다. 같은 단계의 항목을 같은 깊이에 맞추고, 들여쓰기에는 탭 대신 공백을 사용하세요. 문법상 변환에 성공해도 항목이 의도한 부모 아래에 있는지 확인해야 합니다.
- service 아래 name과 port가 같은 깊이면 둘 다 service에 속합니다.
- port를 맨 앞으로 옮기면 service 밖의 별도 항목이 됩니다.
- 출력 들여쓰기 2칸·4칸은 읽기 편한 모양을 고르는 옵션입니다.
주석과 원래 서식은 보존되지 않습니다
YAML의 # 주석은 JSON의 표준 값이 아닙니다. YAML을 JSON으로 바꿀 때 주석을 담을 수 없고, 빈 줄·들여쓰기 폭·따옴표 선택도 다시 만들어집니다. JSON으로 바꿨다가 YAML로 되돌려도 원본과 글자 단위로 일치하지 않을 수 있습니다.
- 주석이 필요한 설정 파일은 원본을 따로 보관하세요.
- 복사 전에는 결과의 키·값·자료형을 확인하세요.
- 왕복 변환을 반복해도 원래 서식이 복원되지는 않습니다.
JSON 오류는 쉼표와 큰따옴표부터 확인하세요
표준 JSON에는 마지막 항목 뒤 쉼표, 작은따옴표로 쓴 이름, 따옴표 없는 이름을 사용할 수 없습니다. JSONC나 JSON5 문서의 주석 등도 이 입력에는 맞지 않습니다. 오류가 가리키는 줄과 바로 앞줄의 구분자·닫는 괄호를 함께 살펴보세요.
- {"port":8080,}는 마지막 쉼표 때문에 거부됩니다.
- {'port':8080}는 작은따옴표 때문에 거부됩니다.
- {port:8080}는 이름을 큰따옴표로 감싸지 않아 거부됩니다.
UTF-8 파일은 1 MiB까지 불러옵니다
파일 불러오기는 UTF-8로 저장한 1 MiB 이하의 JSON·YAML·YML·TXT 파일을 대상으로 합니다. 1 MiB는 1,048,576바이트이며 글자 수와 다릅니다. 한글과 이모지가 많은 파일은 같은 글자 수라도 더 커질 수 있습니다.
- 한글이 깨지면 편집기에서 UTF-8로 다시 저장하세요.
- 큰 파일은 한 개의 완전한 설정 문서 단위로 나누어 확인하세요.
- 불러오기와 변환은 브라우저에서 처리합니다.
여러 문서와 YAML 고유 표현의 한계
일반적인 이름·값·목록의 JSON 호환 YAML 설정 구조를 변환합니다. 한 줄 목록 [web, api]와 한 줄 매핑 {name: app}도 읽습니다. 여러 문서를 구분하는 ---, 앵커·별칭, 병합 키, 사용자 태그, 복잡한 키, | 또는 >로 시작하는 여러 줄 문자열, 여러 줄에 걸친 [ ]·{ } 표현은 지원하지 않습니다. 지원하지 않는 문법은 오류로 알리고, 안전하게 표현할 수 없는 큰 정수와 정밀도가 바뀌는 숫자도 거부합니다.
- 여러 YAML 문서는 문서별로 나누어 입력하세요.
- 별칭·병합·여러 줄 문자열이 있는 설정은 원래 프로그램에서 확인하세요.
- 키 중복은 어떤 값을 남길지 모호해 거부합니다.
설정에 적용하기 전에 세 가지를 확인하세요
변환 성공은 입력 문법을 읽고 다른 형식으로 출력했다는 뜻입니다. 해당 프로그램에서 정상 작동한다는 보장은 아닙니다. 포트 번호나 파일 경로가 문법상 맞더라도 실제 환경에서 사용할 수 없을 수 있습니다. 적용 전에는 프로그램의 설정 검사 기능과 공식 설명서를 확인하세요.
- 필수 항목: 프로그램이 요구하는 이름과 값이 빠지지 않았나요?
- 자료형: 숫자·문자열·참거짓·목록의 구분이 맞나요?
- 적용 위치: 결과를 넣을 파일 형식과 설정 단계가 맞나요?
JSON YAML 변환 자주 묻는 질문
JSON을 YAML로 바꾸면 설정이 바로 작동하나요?
변환은 데이터의 표기 형식을 바꿉니다. 사용하는 프로그램이 YAML을 지원하는지, 필요한 설정 이름과 값의 종류가 맞는지는 별도로 확인해야 합니다.
YAML 주석도 JSON 결과에 들어가나요?
들어가지 않습니다. JSON에는 표준 주석 문법이 없어 YAML의 주석을 같은 형태로 옮길 수 없습니다. 주석이 필요한 원본은 따로 보관하세요.
변환 후 따옴표가 생기거나 사라져도 괜찮나요?
문자열의 의미를 유지하도록 따옴표 표현이 달라질 수 있습니다. 따옴표 모양보다 문자열, 숫자, 참·거짓 값이 의도한 종류로 남아 있는지 확인하세요.
JSONC나 JSON5 파일도 넣을 수 있나요?
이 도구의 JSON 입력은 표준 JSON을 대상으로 합니다. 주석, 작은따옴표, 마지막 항목 뒤 쉼표 등 표준 JSON에 없는 문법을 정리한 뒤 입력하세요.
---로 구분한 YAML 문서를 한꺼번에 바꿀 수 있나요?
한 번에 문서 하나를 변환합니다. 여러 YAML 문서가 들어 있는 파일은 문서별로 나누어 입력하세요.
파일을 불러왔는데 한글이 깨지면 어떻게 하나요?
원본을 편집기에서 열어 UTF-8로 다시 저장한 뒤 불러오세요. 불러올 수 있는 파일 크기는 1 MiB, 즉 1,048,576바이트 이하입니다.
입력한 설정 파일이 서버에 저장되나요?
변환은 브라우저에서 처리하며 입력 내용과 파일을 변환 서버로 업로드하지 않습니다. 복사한 내용과 다운로드한 파일은 사용 중인 기기에서 직접 관리하세요.
JSON과 YAML을 왕복 변환하면 원본과 같아지나요?
주석, 빈 줄, 들여쓰기, 따옴표 같은 서식은 같아지지 않을 수 있습니다. 원본과 결과를 비교할 때는 데이터 구조와 값의 종류를 확인하세요.
JSON·YAML 문법의 원문 자료
자료형과 문서 문법은 아래 원문을 기준으로 확인했습니다. 이 도구의 파일 크기와 지원 범위는 위 이용 안내를 따릅니다.
다른 형식으로 이어서 쓰기
설정의 문자열을 URL 매개변수로 보낼 때는 URL 인코더를, Base64 값을 확인할 때는 Base64 도구를 쓰세요. 텍스트 길이와 UTF-8 바이트 수는 글자수세기에서 확인할 수 있습니다.