CSV → Markdown 표

CSV를 즉시 Markdown 표로 변환. 따옴표 필드 지원, 첫 행을 헤더로 사용, 왼쪽/가운데/오른쪽 정렬 선택 가능. 브라우저에서 처리, 데이터 전송 없음.

  • 브라우저에서 처리
  • 도구 입력을 ZeroTool 서버에 업로드하지 않습니다
  • 무료 · 회원가입 불필요
열 정렬 왼쪽, 가운데 또는 오른쪽을 모든 열에 적용하고 기존 입력의 결과를 바로 갱신합니다. 구분 행이 Markdown 렌더러의 정렬을 결정합니다.
두 패널, 상태, 대기 중인 변환을 지우고 정렬은 유지합니다. 도구 안에 초점이 있으면 Ctrl+L(Mac은 ⌘+L)로도 지울 수 있습니다.
쉼표로 구분한 CSV를 붙여 넣습니다. 첫 행을 헤더로 사용하며 입력을 멈춘 뒤 0.3초 후 표가 갱신됩니다. 따옴표 안의 쉼표와 줄바꿈을 지원합니다.
현재 CSV 입력의 전체 텍스트를 복사합니다. 빈 입력은 복사할 수 없습니다.
Markdown 표를 출력합니다. 셀 안의 파이프는 이스케이프하고 줄바꿈은 공백으로 바꿉니다. 여분의 필드는 이름이 있는 열로 추가하며 상태에 표시합니다.
생성된 Markdown 표 전체를 복사하여 GitHub, GitLab 또는 Markdown 편집기에서 사용할 수 있습니다. 빈 결과는 복사할 수 없습니다.
Markdown 표가 여기에 표시됩니다.
예시·자세한 설명·자주 묻는 질문 실제 출력이 있는 예시, 다른 도구와의 차이, 자주 묻는 질문.

Markdown 표 문법

Markdown 표는 헤더 행, 구분 행, 데이터 행으로 구성되며 파이프 문자(|)로 열을 구분합니다.

| Name  | Age | City     |
| :---- | :-- | :------- |
| Alice | 30  | New York |
| Bob   | 25  | London   |

구분 행으로 정렬을 제어합니다: :--- = 왼쪽, :---: = 가운데, ---: = 오른쪽.

지점별 매출 표

주간 보고서에 넣을 지점별 매출입니다(예시 데이터). 천 단위 쉼표가 있는 금액은 따옴표로 감쌌고, 비고에는 파이프가 들어 있습니다.

지역,매출(원),비고
서울,"1,250,000",
부산,"980,000","신규 매장 | 10월 오픈"
| 지역  | 매출(원)     | 비고              |
| :---- | :---------- | :---------------- |
| 서울  | 1,250,000 |                 |
| 부산  | 980,000   | 신규 매장 \| 10월 오픈 |
  • 따옴표는 빠지고 1,250,000의 쉼표는 셀 안에 남습니다. 따옴표가 없으면 1, 250, 000이 각각 다른 열로 나뉩니다.
  • 비고의 |는 \|로 바뀌어 렌더링 후에도 한 셀 안의 파이프로 보입니다.
  • 열 너비는 글자 수로 세어 공백을 채웁니다. 한글은 고정폭 글꼴에서 두 칸을 차지하므로 원문에서는 열이 어긋나 보이지만, 렌더링된 표에는 영향이 없습니다.

일정표: 줄바꿈과 남는 필드

가운데 정렬로 바꾼 일정표입니다. 첫 일정의 내용에는 따옴표 안에 줄바꿈이 있고, 둘째 일정에는 헤더보다 필드가 하나 더 있습니다.

날짜,시간,내용
10/13(월),10:00,"주간 회의
(3층 회의실)"
10/15(수),14:00,고객 미팅,온라인
| 날짜       | 시간    | 내용             | Column 4 |
| :--------: | :-----: | :--------------: | :--------: |
| 10/13(월) | 10:00 | 주간 회의 (3층 회의실) |          |
| 10/15(수) | 14:00 | 고객 미팅          | 온라인      |

상태 표시줄에는 2행을 Markdown 표로 변환했습니다. 헤더보다 필드가 많은 행이 있어 다음 열을 추가했습니다: Column 4.가 나옵니다. 따옴표 안의 줄바꿈은 공백 하나가 되었고, 남는 온라인은 버려지지 않고 Column 4 열에 들어갔습니다. 열 이름은 복사한 뒤 원하는 이름으로 바꾸세요.

영문 데이터 예시

오른쪽 정렬을 고른 경우입니다.

product,price,units
Widget,9.99,150
"Gadget, large",24.99,42
Cmd|Ctrl+C,1,2
| product       | price | units |
| --------------: | ------: | ------: |
| Widget        | 9.99  | 150   |
| Gadget, large | 24.99 | 42    |
| Cmd\|Ctrl+C   | 1     | 2     |

구분 행이 다른 행보다 넓지만 Markdown 렌더러는 이를 무시하므로 표는 정상적으로 보입니다.

파이프와 따옴표

둘째 행의 파이프는 이미 이스케이프되어 있고, 셋째 행에는 필드 중간에 인치 기호가 있습니다.

표기,의미
a|b,a 또는 b
a\|b,이스케이프됨
5" 파이프,인치 기호
| 표기     | 의미     |
| :------- | :------- |
| a\|b   | a 또는 b |
| a\|b   | 이스케이프됨 |
| 5" 파이프 | 인치 기호  |

그냥 |에는 백슬래시가 붙고 이미 \|인 것은 그대로라서, 두 행 모두 a|b로 보이고 셀이 나뉘지 않습니다. 5 뒤의 "는 필드 맨 앞이 아니므로 문자로 셀에 남습니다.

Markdown 표가 렌더링되는 곳

GitHub과 GitLab은 README, 이슈, 풀 리퀘스트, 위키에서 이 표 문법을 렌더링합니다(GFM 명세: 표). 표는 확장 문법이라 확장 없는 CommonMark에서는 일반 텍스트로 보입니다. Docusaurus, MkDocs, VitePress 같은 정적 사이트 생성기도 GFM 표를 지원합니다. JSON이 필요하면 CSV JSON 변환기를 사용하세요.

제한 사항

  • 쉼표만 구분자로 인식합니다. Excel이나 Google 스프레드시트에서 바로 복사한 텍스트는 탭으로 구분되고, 일부 지역의 CSV는 세미콜론을 씁니다. 둘 다 한 열이 되므로 먼저 쉼표 구분 CSV로 저장하세요.
  • 헤더보다 긴 행이 있으면 열을 추가합니다. 열 수는 가장 긴 행에 맞춥니다. 헤더가 없는 열은 위치에 따라 Column N(네 번째 열이면 Column 4)으로 이름 붙이고 상태 표시줄에 표시합니다. 필드가 적은 행은 빈 셀로 채웁니다.
  • 모든 열에 같은 정렬. 숫자 열만 오른쪽 정렬하려면 복사한 뒤 구분 행을 | :--- | ---: | ---: |처럼 고치세요.
  • 셀 안의 줄바꿈은 공백이 됩니다. Markdown 표 셀에는 줄바꿈을 넣을 수 없습니다. HTML을 허용하는 렌더러라면 <br>을 직접 쓰세요.
  • 서식은 변환하지 않습니다. 셀 텍스트를 그대로 출력하므로 *, _가 Markdown 강조로 해석될 수 있습니다.
  • 파이프는 Markdown 표 생성기와 같은 규칙으로 이스케이프합니다. 앞에 오는 백슬래시가 짝수 개인 파이프에만 백슬래시를 붙이므로, 셀에 이미 \|가 있으면 \| 그대로 출력되고 |로 보입니다. 백슬래시 자체를 보이게 하려면 CSV에 \\|라고 쓰세요. GitHub과 micromark 계열 렌더러(remark, MDX, Astro) 모두 셀이 나뉘지 않습니다.
  • 필드 맨 앞의 큰따옴표만 따옴표로 봅니다. 따옴표 없는 필드 중간의 "는 일반 문자라서 5" 파이프는 그대로 남습니다. 닫히지 않은 따옴표가 있으면 변환을 멈추고 따옴표가 시작된 행 번호를 오류로 알려 줍니다.

FAQ

어떤 CSV 형식이 지원되나요?

쉼표로 구분하고 RFC 4180의 따옴표 규칙을 따르는 CSV입니다. 따옴표로 감싼 필드에는 쉼표, 줄바꿈, 두 번 연달아 쓴 큰따옴표("")를 넣을 수 있습니다. 행 끝은 LF, CRLF, CR을 모두 지원하며 맨 앞의 UTF-8 BOM은 제거합니다. 탭과 세미콜론은 구분자가 아닙니다.

열 정렬은 어떻게 작동하나요?

왼쪽, 가운데, 오른쪽은 언제든 바꿀 수 있고 현재 표가 바로 다시 만들어집니다. 구분 행에는 모든 열에 같은 :---, :---:, ---: 표기를 쓰며, Markdown 렌더러가 이를 보고 셀을 정렬합니다. 열마다 다르게 정렬하려면 복사한 뒤 구분 행을 고치세요.

첫 번째 행이 표 헤더가 되나요?

네. 첫 행은 항상 헤더가 되어 구분 행 위에 놓입니다. 뒤의 행에 헤더보다 필드가 많으면 위치에 따라 Column N이라는 열을 추가하고 상태 표시줄에 알려 줍니다.

데이터가 서버로 전송되나요?

아니요. 표는 브라우저 탭 안에서 만들어지며 CSV는 서버로 전송되지 않고 브라우저 저장소에도 저장되지 않습니다. 입력란 편집을 마치고 포커스를 옮기거나 정렬을 고를 때 페이지 통계가 사용 이벤트를 한 번 기록합니다(도구 이름과 동작 convert만 담고 CSV나 표 내용은 담지 않습니다).

GitHub이나 GitLab에 바로 붙여 넣을 수 있나요?

네. 출력은 GitHub Flavored Markdown(GFM) 표 문법이라 GitHub과 GitLab의 README, 이슈, 풀 리퀘스트, 위키에서 표로 보입니다. 표 확장을 지원하지 않는 렌더러에서는 일반 텍스트로 보입니다.