마크다운 표 생성기

마크다운 표 생성기란

엑셀·구글 시트에서 복사한 데이터나 CSV 파일의 내용을 그대로 붙여넣으면, 파이프(|)와 구분선으로 이뤄진 마크다운 표 문법으로 바꿔주는 도구입니다. 깃허브 README, 노션, 옵시디언, 티스토리 마크다운 에디터 등에 표를 넣을 때 일일이 |와 ---를 손으로 치지 않아도 됩니다. 첫 줄을 헤더(제목 행)로 인식하고, 그 아래에 자동으로 구분선을 삽입해 나머지 행을 본문으로 처리합니다.

실제 사용법

입력창에 데이터를 붙여넣기만 하면 됩니다. 구분자는 두 가지를 지원합니다. 엑셀·시트에서 셀 범위를 복사하면 셀 사이가 탭으로 구분되어 클립보드에 담기므로 그대로 붙여넣으면 열이 정확히 나뉩니다. 텍스트로 정리한 데이터는 쉼표(CSV)로 구분하면 됩니다. 예를 들어 아래처럼 입력하면

다음과 같은 마크다운이 생성됩니다.

결과를 복사해 문서 편집기에 붙여넣으면 렌더링된 표로 표시됩니다.

작동 원리

도구는 입력된 텍스트를 줄 단위로 나눈 뒤, 각 줄을 구분자(탭 또는 쉼표) 기준으로 쪼개 셀 배열을 만듭니다. 첫 줄(헤더)의 열 수를 기준으로 표의 열 수를 정하고, 바로 아래에 그 열 수만큼 --- 구분선을 채웁니다. 헤더보다 칸이 적은 줄은 오른쪽이 빈 셀로 자동 채워져 열 위치가 어긋나지 않습니다. 각 셀 앞뒤에 공백과 파이프를 붙여 마크다운 표 문법을 완성합니다. 셀 안에 파이프 문자가 들어 있으면 표가 깨지므로, 필요 시 \|처럼 이스케이프 처리하거나 다른 기호로 바꿔야 합니다. 열이 정확히 맞으려면 각 줄의 칸 수를 헤더와 같게 맞춰 두는 것이 좋습니다.

활용 상황과 팁

깃허브 저장소 README에 기능 비교표를 넣을 때, 노션 데이터를 마크다운으로 백업할 때, 기술 블로그에 실험 결과 표를 정리할 때 특히 유용합니다. 팁 몇 가지입니다.

1) 엑셀에서 복사할 때는 쉼표 대신 탭 구분을 쓰는 게 안전합니다. 셀 값 안에 쉼표(예: "1,000원")가 있으면 CSV 모드에서 열이 잘못 쪼개지기 때문입니다.

2) 숫자 열을 오른쪽 정렬하려면 생성된 구분선 ---을 ---:로, 가운데 정렬은 :---:로 직접 바꿔주면 됩니다. 마크다운 표는 구분선의 콜론 위치로 정렬을 지정합니다.

3) 열 너비를 맞추려 셀에 공백을 여러 개 넣어도 렌더링 결과는 동일합니다. 소스가 지저분해 보일 뿐 표시에는 영향이 없습니다.

자주 묻는 질문