CSV→Markdown 표 변환기
CSV 파일을 Markdown 표 문법(`| col1 | col2 |`)으로 변환합니다. 구분자, 첫 줄을 표제행으로 사용할지 여부, 열 정렬(왼쪽·가운데·오른쪽)을 지정할 수 있습니다. 변환 결과는 복사하거나 다운로드할 수 있습니다. 변환은 모두 브라우저 내에서 처리되며 서버로 전송되지 않습니다.
| 구분자 |
|
|---|---|
| 첫 줄을 표제행으로 사용 | |
| 열 정렬 |
|
CSV를 입력하면 여기에 Markdown 표가 표시됩니다.
CSV 행과 Markdown 표의 대응 관계
| CSV의 한 행 | name,age,city |
|---|---|
| 변환된 Markdown 문법 | | name | age | city | |
첫 줄을 표제행으로 사용하면 1행이 표제행이 되고, 2행에 정렬을 나타내는 구분행(---)이 이어지며, 3행부터는 각 데이터 행이 됩니다.
CSV→Markdown 표 변환기란
Markdown 표는 파이프와 하이픈만으로 그려지기 때문에 열이 몇 개 안 될 때는 문제없지만, 열 수가 늘어나면 손으로 입력하기가 번거로워집니다. 원본 데이터가 이미 CSV 형태라면 — 스프레드시트에서 내보냈거나, 데이터베이스 조회 결과, 로그 파일 등 — 셀 하나하나를 다시 입력할 필요가 없습니다. 이 도구는 CSV를 읽어들여 표제행, 정렬을 나타내는 구분행, 그리고 각 줄에 대응하는 데이터 행으로 이루어진 Markdown 표를 자동으로 만들어 줍니다.
Markdown 표의 한 행은 물리적으로 한 줄에 담겨야 하므로, 변환 과정에서 몇 가지 처리가 자동으로 이루어집니다. 셀 안에 있는 파이프 문자는 열 구분자로 오인되지 않도록 이스케이프되며, 따옴표로 묶인 여러 줄 셀 안의 줄바꿈은 공백 하나로 치환됩니다. 열 정렬은 왼쪽·가운데·오른쪽 중에서 선택할 수 있고, 선택한 정렬에 맞춰 구분행에 콜론과 하이픈 조합이 삽입됩니다. 모든 처리는 브라우저 안에서 완결되므로 붙여넣은 CSV 내용이 외부로 전송되는 일은 없습니다.
CSV로 Markdown 표를 만드는 방법
- CSV 데이터를 붙여넣습니다 입력란에 CSV 텍스트를 붙여넣습니다. 스프레드시트 프로그램에서 그대로 복사했다면 구분자를 탭으로 바꿔 주세요.
- 표제행 처리 방식을 정합니다 첫 줄이 항목명이라면 "첫 줄을 표제행으로 사용"을 켭니다. 구분행이 자동으로 그 아래에 삽입됩니다.
- 열 정렬을 선택합니다 숫자 열은 오른쪽 정렬로 두면 읽기 편해집니다. "지정 안 함"으로 두면 렌더러의 기본 방식으로 표시됩니다.
- 결과를 복사해 붙여넣습니다 생성된 Markdown을 복사해 README, 이슈, PR 설명, 기술 문서 등에 붙여넣습니다.
더 잘 활용하기 위한 팁
- 셀 안에 파이프(|)가 포함되어 있으면 자동으로 \|로 이스케이프되어 열 구분자로 잘못 인식되는 것을 방지합니다.
- 따옴표로 묶인 여러 줄 셀 안의 줄바꿈은 반각 공백으로 치환됩니다. Markdown 표의 한 행은 물리적으로 한 줄에 들어가야 하기 때문입니다.
- "왼쪽 정렬", "가운데 정렬", "오른쪽 정렬" 중 하나를 선택하면 구분행에 `:---`·`:---:`·`---:`가 삽입되어 GitHub 등의 렌더러에서 의도한 정렬로 표시됩니다.
- 자매 도구인 CSV→JSON 변환·CSV→SQL 변환과 함께 사용하면, 하나의 CSV를 용도에 맞는 세 가지 형식으로 변환할 수 있습니다.
CSV→Markdown 변환의 활용 사례
README에 표 싣기
대응표나 설정 항목 목록을 스프레드시트에서 먼저 정리한 뒤 변환하면, 형식이 흐트러지지 않은 Markdown 표를 얻을 수 있습니다.
이슈나 PR에서 비교 결과 보여주기
검증 결과나 후보 비교를 그 자리에서 표로 만들 수 있습니다. 순수 텍스트이므로 diff에서도 읽기 편합니다.
기술 문서를 위한 자료 정리
측정한 데이터를 그대로 문서의 표로 옮길 수 있습니다. 숫자 열을 오른쪽 정렬하면 자릿수가 맞춰져 보기 편해집니다.
회의록이나 문서 정리하기
스프레드시트로 관리하던 목록을 Markdown으로 관리하는 문서로 옮길 때 유용합니다.
Markdown 표 관련 용어
- 표 문법
- 파이프로 구분한 셀을 나열해 표를 나타내는 Markdown 표기법입니다. 원래 규격에는 없었고 나중에 확장 기능으로 추가되었습니다.
- 구분행
- 표제행 바로 다음에 오는 하이픈으로 이루어진 행입니다. 여기까지가 표제행임을 파서에게 알려 줍니다.
- 정렬 지정
- 구분행의 하이픈 옆에 콜론을 붙여 해당 열의 정렬 방식(왼쪽·가운데·오른쪽)을 나타내는 표기입니다.
- GFM
- GitHub Flavored Markdown의 약자로, GitHub가 정한 확장 규격입니다. 표 문법의 사실상 표준으로 자리 잡았습니다.
- 이스케이프
- 셀 안의 파이프가 열 구분자로 오인되지 않도록 앞에 백슬래시를 붙이는 처리입니다.
자주 묻는 질문
여담 ― Markdown 표는 왜 파이프와 하이픈만으로 표현될까
Markdown은 2004년 John Gruber와 Aaron Swartz가 고안한 경량 마크업 언어로, "평문 그대로 읽어도 의미가 통해야 한다"는 것을 설계 철학의 핵심으로 삼고 있습니다. 표 문법도 예외가 아니어서, 파이프와 하이픈만으로 표의 선을 표현하기 때문에 HTML의 <table> 태그처럼 시작·종료 태그로 감쌀 필요가 없고, 변환 전 소스만 보고도 표의 형태를 대략 짐작할 수 있습니다.
Markdown의 표 문법은 원래 John Gruber 본인이 정한 오리지널 규격에는 포함되어 있지 않았고, 이후 PHP Markdown Extra와 더 큰 영향력을 가진 GitHub Flavored Markdown(GFM)이 독자적으로 추가한 확장 기능입니다. 그래서 구현에 따라 세부 동작(열 개수가 맞지 않을 때의 처리 등)이 미묘하게 다를 수 있으며, GitHub·GitLab 등 주요 플랫폼은 대체로 GFM을 따르고 있습니다.
스프레드시트나 데이터베이스 조회 결과를 그대로 문서에 붙여넣고 싶은 수요는 README·Issue·기술 블로그를 작성할 때 자주 발생합니다. 파이프와 구분행을 손으로 직접 입력하는 것은 번거로운 작업이므로, CSV에서 한 번에 변환할 수 있는 도구는 Markdown으로 문서를 작성하는 개발자들에게 정착된 사전 작업이 되었습니다.