도구 소개
CSV → Markdown은 기존 CSV 파서로 실제 필드를 읽은 다음 헤더, 정렬 구분선, 데이터 행을 생성합니다. 인용된 필드 안의 쉼표를 새 열로 나누지 않으며 Markdown 셀 안의 세로줄도 이스케이프합니다.
사용 방법
- CSV를 붙여 넣고 구분자와 첫 행을 헤더로 사용할지 확인하세요.
- 모든 열에 공통으로 적용할 정렬 방향을 선택하세요.
- "변환"을 누르고 Markdown 헤더, 구분선, 이스케이프된 필드를 확인하세요.
- Markdown을 복사하거나 table.md를 다운로드한 뒤 Markdown 미리보기에서 모양을 확인하세요.
사용 예제
- name,age / Tom,20 → --- 구분선이 포함된 두 열의 Markdown 표.
- CSV 필드 A | B는 Markdown에서 A \| B로 쓰므로 열이 추가되지 않습니다.
- 인용된 필드 안의 CRLF, CR, LF는 모두 <br>로 바뀌며 데이터 행을 추가하지 않습니다.
처리 규칙과 제한
CSV 파싱에는 Papa Parse를 재사용합니다. Markdown 생성 시 역슬래시, 세로줄, 서식 문자를 이스케이프하고 앞뒤 공백과 HTML 문자는 엔티티로 유지합니다. 필드 안의 줄바꿈은 항상 <br>로 바꿉니다. 원시 HTML을 지원하는 플랫폼에서는 줄바꿈으로 표시할 수 있지만, 로컬의 안전한 미리보기에서는 원시 HTML이 비활성화되어 <br>가 텍스트 그대로 표시됩니다. 공통 정렬 옵션은 구분선에 적용하며 구분선을 데이터로 취급하지 않습니다.
주요 활용
- 데이터 요약을 README나 프로젝트 문서에 추가.
- 스프레드시트 내보내기 결과로 Markdown 표 생성.
- 세로줄이 포함된 필드를 수동으로 이스케이프하는 수고 절약.
개인정보 안내
텍스트 처리, 파일 읽기, 변환, 미리보기는 모두 현재 브라우저 안에서 이루어집니다. 입력을 업로드하지 않으며 백엔드, 데이터베이스, 온라인 API, 외부 CDN을 사용하지 않습니다. 내용을 자동 저장하지도 않습니다. 복사와 다운로드도 브라우저 안에서 처리합니다.
FAQ
필드 안의 쉼표가 열을 나누나요?
큰따옴표로 올바르게 감싸면 나누지 않습니다. 쉼표로 단순 분할하지 않고 CSV 파서를 재사용합니다.
세로줄 앞에 역슬래시가 붙는 이유는 무엇인가요?
세로줄은 Markdown 표의 구분자입니다. \|는 필드 안의 일반 세로줄을 뜻합니다.
필드 안의 줄바꿈은 어떻게 되나요?
표의 행 구조를 유지하기 위해 <br>로 바꿉니다. 원시 HTML 지원 여부는 플랫폼마다 다르며 로컬의 안전한 미리보기에서는 이 태그를 텍스트로 보여 줍니다.
필드 안의 HTML을 바로 실행할 수 있나요?
이 도구는 Markdown 텍스트를 출력하며 HTML을 실행하지 않습니다. 원래 HTML 문자는 엔티티로 바뀝니다. 게시 전에는 대상 Markdown 플랫폼의 규칙도 확인하세요.