Markdown 표→CSV 변환기
Markdown 표 문법（`| col1 | col2 |`）으로 작성된 표를 CSV・TSV로 변환합니다. GitHub Wiki・Notion・Confluence 등에서 내보낸 표를 Excel이나 스프레드시트로 가져올 때 사용할 수 있습니다. 변환은 브라우저 내에서 완료되며 데이터는 서버로 전송되지 않습니다.
| 출력 구분자 |
|
|---|---|
| 출력에 헤더 행 포함 |
Markdown 표를 입력하면 생성된 CSV가 여기에 표시됩니다.
Markdown 표의 행과 CSV 행의 대응 관계
| Markdown의 한 행 | | name | age | city | |
|---|---|
| 변환된 CSV의 한 행 | name,age,city |
헤더 행 바로 뒤에 있는 구분 행（`---`・`:---`・`:---:`・`---:`）은 데이터로 취급되지 않고 건너뜁니다. 셀 안에서 이스케이프된 파이프（`\|`）는 일반 "|" 문자로 복원됩니다.
Markdown 표→CSV 변환이란
문서 도구로 만든 표는 눈으로 보기에는 편리하지만, 합계를 내거나 정렬하려면 결국 스프레드시트로 옮겨야 합니다. 이 도구는 Markdown의 표 문법을 읽어 들여 CSV 또는 TSV로 변환하며, 헤더 행 바로 뒤에 오는 구분 행을 자동으로 판별해 데이터로 섞이지 않도록 건너뜁니다.
GitHub Flavored Markdown（GFM） 규격을 따르므로 `| a | b |`처럼 파이프로 감싸는 표기법과, 앞뒤 파이프를 생략한 표기법 모두 문제없이 처리합니다. 셀 값에 쉼표나 큰따옴표가 포함되어 있으면 CSV 규칙에 따라 자동으로 큰따옴표로 감싸지므로 스프레드시트에서 열이 어긋날 걱정이 없습니다. 구분 행을 찾을 수 없는 입력은 표로 인식되지 않습니다.
Markdown 표를 CSV로 바꾸는 방법
- Markdown 표를 붙여넣습니다 문서에서 표 부분을 그대로 복사해 붙여넣습니다. 구분 행도 함께 포함한 상태로 붙여넣어 주세요.
- 출력 형식을 선택합니다 쉼표로 구분되는 CSV와 탭으로 구분되는 TSV 중에서 고를 수 있습니다. 스프레드시트에 바로 붙여넣을 예정이라면 TSV 쪽이 열이 어긋날 가능성이 적습니다.
- 헤더 행 포함 여부를 정합니다 헤더를 따로 관리하고 싶다면 "출력에 헤더 행 포함"을 꺼서 데이터 행만 출력되도록 할 수 있습니다.
- 결과를 복사하거나 저장합니다 변환된 결과를 복사해 스프레드시트에 붙여넣거나, CSV 파일로 저장해 다른 곳에서 불러올 수 있습니다.
더 잘 활용하기 위한 팁
- 헤더 행 바로 뒤의 구분 행은 자동으로 판별되어 건너뛰므로, `---`・`:---`（왼쪽）・`:---:`（가운데）・`---:`（오른쪽） 중 어떤 정렬 지정이라도 문제없이 변환됩니다.
- "출력에 헤더 행 포함"을 비활성화하면 헤더를 제외한 데이터 행만으로 구성된 CSV를 출력합니다. 헤더 부분을 별도로 관리하고 싶을 때 편리합니다.
- 셀 값에 쉼표나 큰따옴표가 포함된 경우 CSV 규칙에 따라 자동으로 큰따옴표로 감싸지며, 내부의 `"`는 `""`로 이스케이프됩니다.
- 자매 도구인 CSV→Markdown 표 변환과 함께 사용하면 CSV와 Markdown 표를 몇 번이든 서로 변환할 수 있습니다.
Markdown→CSV 변환 활용 사례
문서 안의 표 데이터 집계하기
GitHub Wiki나 Notion에서 관리하던 목록을 스프레드시트로 옮겨 정렬하거나 합계를 계산할 수 있습니다.
README의 목록을 데이터로 활용하기
호환성 표나 설정 목록을 CSV로 바꾸면 스크립트에서 곧바로 읽어 들여 검증하거나 다른 파일을 자동 생성하는 데 쓸 수 있습니다.
회의록에서 과제 목록 추출하기
Markdown으로 정리한 과제 목록을 작업 관리 도구가 가져올 수 있는 형식으로 변환할 수 있습니다.
양방향으로 오가며 정리하기
자매 도구인 CSV→Markdown 표 변환과 함께 사용하면 어느 형식에서 시작하든 서로 자유롭게 오가며 변환할 수 있습니다.
Markdown・CSV 관련 용어
- 표 문법
- 파이프로 구분한 셀을 나란히 배열해 표를 나타내는 Markdown 표기법입니다. 헤더 행과 구분 행을 갖는다는 점이 CSV와 다릅니다.
- 구분 행
- 헤더 행 바로 뒤에 놓이는 하이픈으로 이루어진 행입니다. 화면에는 구분선으로 표시되지만 실제 데이터는 아니므로 변환할 때 건너뜁니다.
- GFM
- GitHub Flavored Markdown의 줄임말입니다. 앞뒤 파이프를 생략한 표기법도 허용하며, 이 도구는 두 표기법을 모두 지원합니다.
- TSV
- 탭으로 값을 구분하는 형식입니다. 값에 쉼표가 포함된 데이터나 스프레드시트에 바로 붙여넣을 때 적합합니다.
- 따옴표 처리
- CSV에서 값을 큰따옴표로 감싸는 처리를 말합니다. 값 안에 쉼표나 따옴표가 포함되어 있을 때 필요합니다.
자주 묻는 질문
여담 ― Markdown 표와 CSV는 무엇이 다른가
CSV와 Markdown 표는 둘 다 표 형식 데이터를 텍스트로 표현하는 문법이지만 목적이 다릅니다. CSV는 Excel・데이터베이스 등 "프로그램이 읽고 쓰는" 것을 전제로 한 기계 판독용 포맷인 반면, Markdown 표는 "사람이 소스를 봐도 어느 정도 표의 형태를 알 수 있는" 것을 중시한, 문서 작성을 위한 문법입니다.
그렇기 때문에 Markdown 표에는 CSV에는 없는 헤더 행과 구분 행（`---`）이라는 개념이 존재합니다. 이 구분 행은 화면에는 구분선으로 표시되지만, 소스상으로는 단순한 하이픈의 나열에 불과하며, 파서에게 "여기까지가 헤더이고, 여기서부터는 데이터 행이다"라고 알리기 위해서만 존재하는 Markdown 특유의 문법입니다.
GitHub Wiki・Notion・Confluence 등의 문서 도구에서 작성한 표를 스프레드시트로 옮기고 싶은 상황은 팀 회의록이나 README를 정리할 때 자주 발생합니다. 반대 방향인 CSV→Markdown 변환 도구와 함께 갖춰 놓으면, 어느 형식을 기준으로 하든 망설임 없이 변환할 수 있습니다.