CSV를 Markdown 표로 만들기: README에 표 붙여넣는 방법
DataWork Tools 편집 · 2026년 11월 3일
작은 데이터 사전, 테스트 결과, 코드 목록을 README에 정리할 때 셀마다 파이프를 넣는 일은 반복적입니다. CSV를 Markdown으로 변환하면 헤더와 구분선을 한 번에 만들고 문서에서 검수할 수 있습니다. 수만 행 원본을 문서에 모두 붙이기보다 독자가 확인해야 할 범위만 고르는 것이 좋습니다.
Markdown 표의 기본 구조
| 사번 | 이름 | | --- | --- | | 0012 | 김민수 | | 0024 | 이지은 |
첫 줄은 헤더이고 다음 줄은 헤더 구분선입니다. 이후 줄이 데이터입니다. 이 도구는 첫 CSV 행을 헤더로 사용하며 빈 헤더나 중복 헤더를 허용하지 않습니다. 엑셀에서 복사했다면 입력 구분자를 탭으로 선택하세요.
셀 안에 파이프가 있으면?
A|B를 그대로 넣으면 새 열로 보일 수 있어 파이프 앞에 역슬래시를 붙입니다. 역슬래시·별표·밑줄·백틱 등도 문자로 보이도록 이스케이프합니다. 표 안에서 별표로 굵게 표시하려던 경우에도 문자 그대로 출력하므로 필요한 서식은 최종 문서에서 따로 적용하세요.
HTML은 실행하지 않고 문자로
입력에 <script>나 <img>가 있어도 그대로 HTML 태그로 출력하지 않습니다. 꺾쇠와 앰퍼샌드를 엔티티로 바꿔 문서 렌더러가 텍스트로 읽도록 합니다. 도구 화면의 미리보기도 HTML 삽입 대신 텍스트 셀을 사용합니다.
줄바꿈과 편집기 차이
셀 내부 줄바꿈은 <br>로 출력해 Markdown 행이 여러 줄로 갈라지는 것을 피합니다. GitHub 스타일 표를 지원하지 않거나 HTML을 비활성화한 편집기에서는 표나 줄바꿈이 다르게 보일 수 있습니다. 결과를 복사한 뒤 실제로 게시할 편집기의 미리보기를 확인하세요.
공개 문서에 옮기기 전 체크
- 고객 이름, 이메일, 비공개 매출 등 공개하면 안 되는 값이 없는지 확인합니다.
- 사번 0012, 빈 셀, 파이프가 포함된 셀을 대조합니다.
- 큰 표는 열 편집으로 필요한 열만 남깁니다.
- Markdown은 문서 형식이며 이후 다시 CSV로 가져오는 용도로는 원본 파일을 보관합니다.
함께 읽기
CSV 한글이 깨질 때: UTF-8과 EUC-KR 구분하기
사번 0012가 12로 바뀌는 이유와 보존 방법
CSV를 SQL INSERT로 바꾸기 전 확인할 5가지
중복 제거에서 전체 행과 기준 열은 어떻게 다를까?
두 CSV 파일 비교: 추가·삭제·변경 행을 찾는 방법
VLOOKUP 없이 두 CSV 합치기: LEFT와 INNER JOIN 차이
CSV 열 순서 바꾸기·열 이름 변경·불필요한 열 삭제
JSON을 CSV로 변환할 때 빈칸·중첩 데이터·큰 숫자 확인하기
JSON 문법 오류 찾기: 따옴표·쉼표·큰 숫자 검수 방법
CSV 파일 분할과 행·열 전치: 처리 순서와 결과 검수
CSV 공백과 빈 행 정리: 지워도 되는 값부터 구분하기
CSV와 TSV 차이: 엑셀에서 복사한 표를 파일로 바꾸기
CSV 정렬에서 10이 2보다 먼저 나오는 이유: 문자열과 숫자 정렬
CSV에서 필요한 행만 추출하기: 포함·일치·빈값 필터의 차이