CSV를 단순한 쉼표 구분 줄로 처리하기
쉼표는 따옴표로 감싼 필드 안에 들어갈 수 있고 그 필드는 실제 줄바꿈도 포함할 수 있습니다. 단순히 쉼표나 줄 단위로 나누면 레코드가 손상됩니다. CSV 모드를 사용하고 따옴표 오류를 모두 해결한 뒤 행 수를 신뢰하세요.
데이터 테이블 워크벤치 | CSV·JSON을 Markdown 표로
변환브라우저에서 실행(업로드 없음)
CSV 행이나 JSON 객체 배열을 제한된 범위에서 로컬 GFM 표로 변환합니다. 구분자를 감지하고 실제 표 미리보기를 확인하며, 중첩 JSON은 축약 텍스트로 보존합니다. 불균일한 행, 생성된 헤더, 여러 줄 셀, 숫자 정밀도 경계도 숨기지 않고 알립니다.
다음에 할 작업
관련 작업 흐름을 이어가거나 이 작업 다음에 자주 사용하는 도구를 열어보세요.
작업 가이드
데이터를 손상시키지 않고 CSV·JSON 레코드를 Markdown 표로 변환하기
문서 표는 원본 구조, 변환 규칙, 게시 결과가 일치할 때만 신뢰할 수 있습니다. 이 절차는 민감 정보를 제거한 대표 fixture에서 시작해 따옴표 CSV와 엄격한 JSON 객체 배열을 구분하고, 큰 숫자와 중첩 값을 보호하며, 생성 헤더와 빈 셀 보정을 모두 확인한 뒤 실제 게시 렌더러에서 완성된 GFM을 검증합니다.
열기관련 도구CSV JSON 양방향 변환기 | 로컬·손실 방지 변환
문자열 보존 타입 처리, 엄격한 구조 검사, 보호된 스프레드시트 출력으로 CSV와 JSON을 로컬 변환합니다.
열기관련 도구텍스트·코드·Unified Patch Diff 비교기
정확한 줄 hunk, 코드 포인트 강조, unified patch로 제한된 텍스트를 로컬 비교합니다.
열기관련 도구JSON 포매터 | 원문을 보존해 보기 좋게 정리·압축
중복 키와 숫자 원문을 보존하며 엄격한 JSON을 로컬에서 정리하거나 압축합니다.
열기이 도구 사용 방법
원본 구조에 따라 CSV 또는 JSON을 선택합니다. 대표 표본을 넣기 전에 비밀값, 토큰, 고객 개인정보, 작업에 필요 없는 열을 제거하세요.
CSV에서는 자동 감지 또는 쉼표, 탭, 세미콜론, 파이프, 한 글자 사용자 구분자를 선택합니다. 첫 번째 비어 있지 않은 행이 실제 헤더인지 확인하세요.
정렬 없음, 왼쪽, 가운데, 오른쪽 중 하나를 선택합니다. 이 설정은 모든 열에 같은 GFM 구분 형식을 적용하며 숫자 의미를 자동 추론하지 않습니다.
변환 후 보고된 행 수, 열 수, 입력 바이트, 출력 바이트를 원본과 비교합니다. 따옴표, 구조, 숫자 정밀도, 자원 한도 오류가 있으면 먼저 원본을 고치세요.
빈 행 건너뜀, 불균일 레코드, 생성·중복 헤더, 중첩 JSON, null, 여러 줄 셀, 가장자리 공백, HTML 형태 텍스트 인코딩 경고를 모두 읽으세요.
안전한 표 미리보기를 본 뒤 Markdown을 복사하거나 다운로드하고 실제 목적지의 렌더러, 링크 검사, 모바일 레이아웃, 검토 절차에서 게시 전에 확인하세요.
이 도구를 써야 할 때
스프레드시트 내보내기를 README 표로 변환
검토한 스프레드시트 내보내기를 붙여 넣고 따옴표 쉼표와 불균일 행을 확인한 뒤 README용 호환성 표나 릴리스 표를 만듭니다.
대표 API 응답 문서화
작은 API 예제 객체 배열을 변환하면서 false, 0, null, 뒤에서 추가된 키를 보존해 문서 페이지에 사용합니다.
운영 내보내기를 런북 증거로 변환
지역별 내보내기의 탭이나 세미콜론을 감지하고 실제 구분자를 확인해 데스크톱 스프레드시트 앱 없이 운영 런북용 표를 만듭니다.
작은 스키마 마이그레이션 fixture 검토
생성된 행·열 수를 마이그레이션 fixture와 비교하고 Markdown diff를 코드 리뷰나 데이터 계약 변경에 첨부합니다.
정제된 사고 대응 표 준비
민감 정보를 제거한 레코드에서 읽기 쉬운 사고 대응 부록을 만들고 HTML 형태 값을 비활성으로 유지한 뒤 최종 렌더러를 확인합니다.
흔한 실수
첫 데이터 행을 헤더로 잘못 사용하기
GFM 표에는 항상 헤더와 구분 행이 필요합니다. 원본에 헤더가 없다면 첫 행 옵션을 해제해 첫 데이터 레코드를 잘못 승격하지 말고, 워크벤치가 중립적인 Column 1 헤더를 만들게 하세요.
모든 JSON 숫자가 JavaScript에서 정확하다고 가정하기
브라우저의 안전한 정수 범위를 넘는 JSON 숫자나 파싱 중 반올림되는 소수는 식별자와 측정값을 바꿀 수 있습니다. 워크벤치는 이런 값을 거부하므로 정확한 식별자는 JSON 문자열로 표현하거나 원본 계약을 수정해야 합니다.
중첩 JSON 텍스트를 완성된 데이터 모델로 사용하기
객체와 배열 값은 하나의 셀 안에 축약 JSON으로 직렬화됩니다. 정보는 남지만 관계형 구조를 평탄화하지는 않습니다. 독자가 정렬 가능한 원자 열을 필요로 한다면 중첩 레코드를 다시 설계하거나 필요한 필드만 선택하세요.
목적지 렌더러 확인 없이 게시하기
내장 미리보기는 이번 변환만 확인합니다. GitHub, 문서 생성기, 위키, 이메일 렌더러는 raw HTML, 줄바꿈, 열 너비, 모바일 넘침을 다르게 처리할 수 있습니다. 실제 게시 위치에서 복사한 표를 다시 검사하세요.
예시
따옴표 CSV와 리터럴 파이프 변환
따옴표 안의 쉼표는 하나의 셀로 유지되고 파이프는 이스케이프되어 Markdown 열을 추가로 만들지 않습니다.
입력
이름,역할\n"러브레이스, 에이다",엔지니어 | 작가출력
이름이 한 셀에 유지되고 역할 셀은 엔지니어 \| 작가로 표현된 2열 GFM 표세미콜론 구분 내보내기 감지
일관된 표본에서 세미콜론을 자동 감지하고 실제 선택된 구분자를 변환 세부 정보에 표시합니다.
입력
이름;팀\n그레이스;컴파일러\n캐서린;비행 연구출력
첫 행을 이름과 팀 헤더로 사용하는 2열 표열 수가 다른 CSV 행 정규화
짧은 세 번째 레코드는 빈 셀로 채우되 불균일 행 경고를 계속 표시해 원본을 검토할 수 있게 합니다.
입력
이름,팀,지역\n에이다,수학,런던\n그레이스,컴파일러출력
그레이스의 지역 셀이 비어 있고 불균일 행 경고가 있는 3열 표구조가 다른 JSON 객체의 키 합치기
모든 객체의 키를 처음 등장한 순서대로 모으므로 뒤 레코드에서 새로 나온 속성도 별도 열을 가집니다.
입력
[{"이름":"에이다","활성":true},{"이름":"그레이스","점수":0}]출력
이름, 활성, 점수 열이 있고 누락 값은 비어 있지만 false와 0은 유지되는 표중첩 값을 축약 JSON으로 보존
중첩 객체와 배열을 모호한 자리표시자로 바꾸지 않고 축약 JSON 텍스트로 보존하며 검토 안내를 표시합니다.
입력
[{"프로젝트":"문서","담당":{"팀":"웹"},"태그":["gfm","qa"]}]출력
담당과 태그 셀에 각각 축약 JSON이 들어간 한 행HTML 형태 입력을 비활성 표 텍스트로 유지
마크업처럼 생긴 값은 표 텍스트로 인코딩됩니다. 결과에 활성 img 요소를 만들지는 않지만 게시 시스템의 Markdown 보안 정책은 별도로 적용해야 합니다.
입력
[{"메모":"<img src=x onerror=alert(1)>"}]출력
활성 HTML이 아니라 <img ... >가 눈에 보이는 텍스트로 들어간 메모 셀엄격한 파싱, 정확한 한도, 단일 이스케이프 계약, 로컬 미리보기
CSV 모드는 CSV 변환을 실행할 때만 Papa Parse를 불러옵니다. 따옴표 안의 구분자, 이중 따옴표, 포함된 줄바꿈, CRLF, 구분자 감지를 처리합니다. 맨 앞 byte-order mark 하나를 제거하고 완전히 빈 행을 제외하며 따옴표 오류를 거부합니다. 가장 넓은 행을 기준으로 부족한 끝 셀을 채우되 불균일 행 경고는 남깁니다.
JSON 모드는 주석과 후행 쉼표를 허용하지 않는 저장소의 엄격 JSON 파서를 사용합니다. 루트는 객체 배열이어야 합니다. 같은 키가 앞 값을 덮어쓰기 전에 중복 키를 거부하고, JavaScript가 반올림할 안전 범위 밖 정수나 손실 소수를 원문 숫자 검사로 차단합니다. 속성 순서는 전체 레코드에서 키가 처음 나온 순서를 따릅니다.
모든 결과는 하나의 Markdown 렌더러를 사용합니다. 백슬래시와 파이프를 이스케이프하고, 원본 줄바꿈은 생성된 <br> 표시로 바꾸며, 앞뒤 공백은 non-breaking 엔터티로 표현합니다. 원본의 HTML 의미 문자는 인코딩하여 사용자 텍스트가 생성 표에서 활성 HTML 요소가 되지 않게 합니다.
원본과 파싱 결과를 각각 측정해 Unicode 코드포인트 262,144개, UTF-8 524,288바이트, 행 5,000개, 열 100개, 정규화 셀 200,000개, 셀당 32,768문자, 출력 5,000,000바이트 한도를 적용합니다. 다중 바이트 텍스트를 정직하게 다루기 위해 문자와 바이트 한도를 분리합니다.
브라우저 미리보기는 헤더와 셀을 주입 HTML이 아닌 React 텍스트로 렌더링합니다. 정상 변환은 원본이나 결과를 담은 애플리케이션 요청을 만들지 않습니다. 동의 기반 분석에는 부모 slug, 모드, 옵션 이름, 처리 시간, 바이트와 차원 합계, 진단 수만 전달하며 사용자 구분자 데이터, 필드명, 값, Markdown은 전달하지 않습니다.
자주 묻는 질문
CSV나 JSON 셀 값이 업로드되나요?
아닙니다. 변환은 브라우저에서 실행됩니다. 동의 후 선택한 모드, 안전한 옵션 이름, 바이트 수, 행·열 수, 처리 시간, 경고 합계는 측정될 수 있지만 원본 셀 값과 생성된 Markdown은 분석 이벤트에 포함하지 않습니다.
CSV 파싱은 쉼표로 나누는 방식과 어떻게 다른가요?
CSV 모드는 Papa Parse로 따옴표 필드, 이중 따옴표, 자동 또는 직접 선택한 구분자, 줄바꿈 형식을 처리합니다. 잘못된 따옴표 레코드는 거부하고, 맨 앞 BOM을 제거하며, 완전히 빈 행은 건너뛰고, 열 수가 다른 행은 빈 셀로 채우기 전에 경고합니다.
어떤 JSON 구조를 사용할 수 있나요?
JSON 루트는 비어 있지 않은 배열이어야 하고 모든 항목은 객체여야 합니다. 키는 처음 등장한 순서로 합칩니다. 중첩 배열과 객체는 축약 JSON 텍스트가 되고 null은 빈 셀이 됩니다. 중복 키와 정밀도를 잃는 숫자는 거부합니다.
Markdown 셀 텍스트는 어떻게 바뀌나요?
파이프와 백슬래시는 이스케이프하고 원본 줄바꿈은 생성된 <br> 표시로 바꿉니다. 셀 가장자리 공백은 non-breaking 엔터티로 표현하며 HTML 의미를 가질 수 있는 원본 텍스트는 인코딩합니다. 열 구조를 지키는 규칙이며 목적지별 Markdown 동작은 다시 확인해야 합니다.
처리 한도는 얼마인가요?
한 번에 Unicode 코드포인트 262,144개, UTF-8 524,288바이트, 파싱된 행 5,000개, 열 100개, 정규화 셀 200,000개, 셀 하나당 32,768문자까지 처리합니다. 생성 Markdown은 UTF-8 5,000,000바이트로 제한합니다.
게시 전에 표를 어떻게 검증해야 하나요?
행·열 수를 원본과 비교하고 경고 목록과 표 미리보기를 확인하세요. 그다음 .md 파일을 복사하거나 다운로드해 실제 GitHub, 위키, 정적 사이트, 문서 엔진에서 렌더링하고 좁은 화면과 긴 연속 문자열도 검사해야 합니다.
이 도구를 검증한 방법
관리 및 검수 SimpleWebUtils검토일
검증 방법: “뒤에서 추가된 키, 0, 중첩 담당자를 포함한 API fixture 문서화” 문서 입력을 데이터 테이블 워크벤치에 그대로 넣었습니다. 수행 순서는 “원본 계약이 CSV인지 JSON인지 확인합니다”, “파서, 구조, 정밀도 진단을 모두 해결합니다”였고 브라우저 결과를 예시 출력과 대조했습니다. 실패 경계는 “실제 운영 데이터를 편리한 표본으로 사용하기”, “내보내기 설정 확인 없이 구분자 감지를 믿기” 두 항목으로 나눠 검토했습니다.
기대 결과: GFM 표는 처음 등장한 열 순서를 유지하고 중첩 owner를 축약 JSON으로 표시했으며, false와 0을 보존하고 없는 score 셀만 비워 두었습니다.
검증한 작업 가이드 열기관련 작업 가이드
도구를 열기 전에 자주 쓰는 작업 흐름과 예시를 확인하세요.
관련 도구
관리 중인 다른 작업 흐름을 이어서 사용해 보세요
CSV JSON 양방향 변환기 | 로컬·손실 방지 변환
문자열 보존 타입 처리, 엄격한 구조 검사, 보호된 스프레드시트 출력으로 CSV와 JSON을 로컬 변환합니다.
변환
텍스트·코드·Unified Patch Diff 비교기
정확한 줄 hunk, 코드 포인트 강조, unified patch로 제한된 텍스트를 로컬 비교합니다.
텍스트
JSON 포매터 | 원문을 보존해 보기 좋게 정리·압축
중복 키와 숫자 원문을 보존하며 엄격한 JSON을 로컬에서 정리하거나 압축합니다.
포맷팅
JSON 검증기 | 엄격한 구문 오류 위치 찾기
엄격한 JSON 구문을 로컬에서 검사하고 정확한 오류 위치와 중복 키 경고를 표시합니다.
포맷팅
Markdown 미리보기 | 정제 HTML 변환기
Markdown을 로컬에서 미리 보고 표, 작업 목록, 코드, 수식, 각주가 포함된 정제 HTML을 만듭니다.
포맷팅