CSV를 Markdown 표로 변환

작동 방식

Markdown 표는 손으로 쓰기 번거롭고 정렬에 관대하지 않습니다. 데이터가 이미 CSV로 있다면 변환은 즉시 끝나며, 표 전체를 망가뜨리는 파이프 문자 개수 실수도 피할 수 있습니다.

따옴표 처리

파서는 따옴표로 묶인 필드를 이해하므로 셀 안의 쉼표와 줄바꿈이 유지됩니다. 데이터에 있는 파이프 문자는 이스케이프됩니다. 이스케이프하지 않은 파이프는 셀을 일찍 끝내 버리기 때문입니다.

머리글 행

첫 행이 표의 머리글이 되며 열 수를 정합니다. 값이 적은 행은 채워져서 표가 직사각형을 유지하며, 이는 Markdown이 요구하는 조건입니다.

CSV를 읽는 방법

필드는 쉼표로 구분합니다. 큰따옴표로 묶인 필드는 쉼표와 줄바꿈을 포함할 수 있으며, 그 안의 큰따옴표 두 개("")는 따옴표 하나를 뜻합니다. Windows와 Unix 줄 끝이 모두 작동하며 빈 줄은 건너뜁니다.

표의 모양

첫 행이 머리글 행이 되고 그 뒤에 Markdown이 요구하는 --- 구분선이 붙습니다. 이후의 모든 행은 머리글의 열 수에 맞춰 채우거나 잘라내며, 셀 안의 |는 표가 깨지지 않도록 \|로 이스케이프됩니다.