사용법

JSON을 온라인으로 포맷하는 방법

API 응답이나 설정 파일에서 나온 원시 JSON은 흔히 한 줄로 길게 압축되어 있습니다. 그 상태로 읽거나 디버깅하거나 편집하는 것은 고통스럽습니다. 이 가이드는 세 번의 클릭으로 JSON을 적절한 들여쓰기로 예쁘게 정렬하고, 구문 오류를 검증하고, 필요하면 다시 압축하는 방법을 보여줍니다. 모든 작업은 브라우저에서 실행되며 데이터는 탭을 벗어나지 않습니다.

단계별 안내

JSON 포맷터를 열고 왼쪽 패널에 JSON을 붙여 넣으세요. 클립보드에서 직접(Ctrl+V), 명령줄 curl 응답에서, 또는 어떤 텍스트 편집기에서든 붙여 넣을 수 있습니다. 입력은 도구의 한도 내에서라면 어떤 크기든 받습니다.
모드를 고르세요. 포맷은 들여쓰기를 추가합니다(2칸 또는 4칸, 선택 가능). 검증은 JSON을 수정하지 않고 구문만 확인합니다. 압축은 모든 공백을 제거해 가능한 한 가장 작은 출력을 만듭니다. 대부분의 경우에는 포맷이 원하는 기능입니다.
실행을 클릭하세요. 포맷된 출력이 오른쪽 패널에 나타납니다. 복사 버튼으로 복사해 편집기나 설정 파일에 다시 붙여 넣으세요. 도구는 줄 수와 문자 수를 표시해 출력 크기를 한눈에 확인할 수 있게 해줍니다.

오류 메시지 읽기

JSON에 구문 오류가 있으면 포맷터는 파싱을 깨뜨린 정확한 문자를 가리키는 위치(줄과 열)와 함께 오류를 보여줍니다. 흔한 원인으로는 배열이나 객체의 마지막 항목 뒤에 붙은 후행 쉼표(JavaScript에서는 유효하지만 JSON에서는 아님), 빠지거나 남는 닫는 괄호, 큰따옴표로 감싸지 않은 키, 문자열 안에서 이스케이프되지 않은 특수 문자가 있습니다. 표시된 위치를 고치고 다시 실행하세요.

JSON, YAML, CSV: 언제 무엇을 쓸까

JSON은 코드가 소비해야 하는 API 응답과 설정 파일의 표준입니다. YAML은 사람이 편집하는 설정에 선호됩니다(구두점이 적고 주석을 지원함). CSV는 스프레드시트가 소비하는 표 형식 데이터에 가장 적합합니다. 이 사이트의 데이터 변환기로는 이 세 가지 형식을 한 단계로 변환할 수 있습니다. JSON을 붙여 넣고 변환을 클릭하면 YAML이나 CSV가 나옵니다. 압축된 JSON은 데이터를 URL 쿼리 매개변수나 크기 제한이 있는 HTTP 헤더에 담아야 할 때도 유용합니다.

이 가이드에서 사용하는 도구

자주 묻는 질문

제 JSON이 서버로 전송되나요?

아니요. 포맷터는 전적으로 브라우저에서 실행됩니다. JSON은 브라우저의 기본 JSON.parse로 파싱되고 출력은 메모리에서 만들어집니다. 어떤 것도 네트워크로 오가지 않습니다. JSON에 API 키, 토큰, 내부 데이터, 개인 정보가 담겨 있을 때 이 점이 중요한데, API 디버깅 작업에서는 흔한 일입니다.

붙여 넣을 수 있는 최대 크기는 얼마인가요?

포맷터는 최대 5MB까지의 JSON을 받습니다. 그 이상이면 메인 스레드에서 파싱하다가 아무런 피드백 없이 브라우저 탭이 멈출 수 있습니다. 더 큰 JSON 파일에는 명령줄의 jq 같은 전용 데스크톱 도구를 사용하세요(jq . file.json). jq는 수백 메가바이트도 문제없이 처리합니다.