JSON과 CSV를 Markdown 표로 변환하는 방법

JSON과 CSV를 표로 다루는 상황

JSON이나 CSV로 가진 자료를 Markdown 표 형태로 정리해야 할 때 이 도구를 사용할 수 있습니다. 입력란에는 파일 경로가 아니라 표로 바꿀 텍스트를 넣고, 그 내용에 맞는 형식을 선택합니다. 처리가 성공하면 행과 열을 구분하는 Markdown 표 텍스트가 결과로 표시됩니다. 개발 문서나 README처럼 Markdown 문법을 해석하는 곳에 넣기 전에 헤더, 행, 값의 배치를 먼저 살펴보면 원본과 결과의 대응 관계를 확인하기 좋습니다.

JSON과 CSV는 같은 표를 표현하더라도 입력 방식이 다릅니다. JSON에서는 값의 구조가 행으로 해석될 수 있어야 하며, CSV에서는 줄과 쉼표가 열과 행을 나누는 기준이 됩니다. 열 이름을 직접 정하거나 표의 정렬 방향을 바꾸고 싶다면 선택 항목과 사용자 지정 헤더를 함께 검토하세요. 반대로 빈 입력, 지원하지 않는 형식, 표 행으로 해석하기 어려운 JSON은 성공적인 표 결과로 이어지지 않을 수 있습니다.

입력 설정과 변환 순서

1. 표로 만들 텍스트를 입력란에 넣습니다. 아무 데이터도 제출하지 않으면 표가 생성되지 않고 처리가 실패하므로, 변환할 내용을 먼저 준비해야 합니다. 입력 형식은 지원되는 json 또는 csv 중 하나로 지정합니다. 그 밖의 형식 값을 사용하면 처리가 실패합니다.

2. JSON을 선택했다면 문법과 행 구조를 함께 확인합니다. 비어 있지 않은 JSON 객체는 하나의 표 행으로 다뤄질 수 있습니다. 적절한 행 형태를 제공하고 사용자 지정 헤더를 비워 두면 첫 행의 키가 헤더로 사용됩니다. 빈 목록이나 null처럼 값이 비어 있는 JSON은 채워진 행으로 쓰이지 않으므로, 자료가 실제로 값을 포함하는지 살펴봅니다.

3. CSV를 선택할 때 사용자 지정 헤더를 쓰지 않으면 첫 줄이 헤더가 되고 그다음 줄부터 행으로 처리됩니다. 첫 줄에 열 이름이 들어 있는지 확인한 뒤 내용을 입력하세요. 열 이름을 따로 지정하려면 헤더를 쉼표로 나눈 텍스트로 입력합니다. 이때 각 헤더의 앞뒤 공백은 제거됩니다.

4. 필요한 경우 정렬 방향을 지정합니다. 사용할 수 있는 값은 left, center, right이며, 별도로 정하지 않으면 왼쪽 정렬이 기본값입니다. 변환을 실행한 뒤 결과가 Markdown 표 텍스트로 나오는지 확인하고, 헤더 수와 각 행의 값이 원한 순서인지 대조합니다.

5. 결과가 나오지 않으면 입력 형식, JSON 문법, JSON의 행 구조를 차례로 점검합니다. JSON 문법이 잘못된 경우에는 성공 결과가 반환되지 않습니다. 문법이 올바른 JSON이라도 예상한 행 구조를 제공하지 않는 형태는 처리 중 실패할 수 있으므로, 단순히 따옴표만 고치기보다 표의 행과 열로 해석될 구조인지 다시 확인합니다.

생성된 표와 입력 보존 범위

성공한 결과는 Markdown 표 문법을 가진 텍스트입니다. 첫 줄에 열 이름이 보이고 그 아래에 구분선과 데이터 행이 이어지는지 살펴보면 표의 기본 구조를 읽을 수 있습니다. JSON 객체를 사용했다면 객체의 키가 헤더가 되었는지 확인하고, CSV를 사용했다면 첫 줄을 헤더로 해석한 결과가 의도와 맞는지 확인합니다. 사용자 지정 헤더를 넣은 경우에는 입력한 순서와 공백이 정리된 이름이 결과에 반영되는지 비교합니다.

빈 JSON 값은 데이터가 들어 있는 표가 아니라 빈 표 결과로 취급됩니다. 빈 목록, 빈 객체, null, false, 0, 빈 문자열이 이 범주에 포함됩니다. 따라서 숫자 0이나 거짓 값 하나를 유효한 데이터 행으로 기대했다면 결과의 의미를 다시 판단해야 합니다. 반면 JSON의 문법 오류는 빈 표와 같은 상황이 아니라 실패 결과에 해당하며, 행 구조가 예상과 다른 유효한 JSON도 같은 방식으로 처리되지 않을 수 있습니다.

CSV 결과를 읽을 때는 값의 보존 범위에도 주의합니다. 줄바꿈과 쉼표를 기준으로 필드가 나뉘고 각 필드의 앞뒤 공백이 제거되므로, 쉼표가 들어간 값을 인용부호로 감싼 고급 CSV 표현을 원본 그대로 처리한다고 가정해서는 안 됩니다. 헤더보다 많은 필드는 결과에서 제외될 수 있고, 값이 부족한 행의 빈 칸은 빈 값으로 나타날 수 있습니다. 그러므로 표를 다른 문서에 옮기기 전에는 열 수, 공백 정리, 누락된 값, 행 순서를 원본과 대조하는 것이 좋습니다.

정렬 값이 세 가지 지원 선택지 밖에 있으면 왼쪽 정렬 표식으로 처리됩니다. 이 동작은 입력 오타를 알려 주는 검증 결과와 같지 않으므로, 가운데나 오른쪽 정렬을 기대했다면 사용한 값을 다시 확인해야 합니다. 결과가 성공했더라도 데이터 구조와 CSV 구분 방식에 따라 내용이 달라질 수 있다는 점을 염두에 두고 최종 표를 검토하세요.

사용 예시

상품명과 가격을 한 줄의 표로 정리하려는 상황에서 두 키를 가진 JSON 객체를 입력합니다.

상품명과 가격을 키로 하고 노트북과 1200000을 값으로 가진 JSON 객체를 입력한 뒤 JSON 형식으로 변환을 실행합니다.

헤더에는 상품명과 가격이 표시되고, 그 아래 한 행에 노트북과 1200000이 들어간 Markdown 표 텍스트가 표시됩니다.

제한 사항

• CSV는 줄바꿈과 쉼표로 필드를 나누고 앞뒤 공백을 제거하므로, 인용부호 안의 구분자 같은 고급 CSV 규칙까지 처리된다고 볼 수 없습니다.

자주 발생하는 오류

• JSON 문법은 맞지만 배열이나 중첩 구조가 예상한 행 형태를 제공하지 않으면 실패할 수 있습니다. 중괄호와 대괄호의 짝, 쉼표와 따옴표를 확인한 다음 표의 한 행으로 해석할 수 있는 구조로 다시 정리하세요.

자주 묻는 질문

JSON을 입력하면 언제나 표가 생성되나요?

표가 생성되지 않을 수 있습니다. JSON 문법이 잘못되었거나 표의 행으로 해석하기 어려운 유효한 구조를 사용하면 처리에 실패할 수 있으므로, 입력 형태와 행 구조를 함께 확인하세요.

CSV의 첫 줄을 데이터 행으로 사용할 수 있나요?

사용자 지정 헤더를 입력하지 않은 경우에는 첫 줄이 헤더로 처리됩니다. 첫 줄을 데이터로 삼고 싶다면 해당 줄이 헤더로 해석된다는 점을 고려해 입력 구성을 바꾸거나 사용자 지정 헤더를 지정해야 합니다.

지원되지 않는 정렬 값을 입력하면 어떻게 되나요?

지원 목록 밖의 값을 입력하면 왼쪽 정렬 표식으로 처리됩니다. 가운데 또는 오른쪽 정렬이 필요할 때는 center나 right를 사용했는지 확인하세요.