마크다운 표 생성기 (엑셀·CSV → 표)

손으로 파이프를 맞추지 마세요

마크다운 표는 문법이 단순합니다 — 파이프(|)로 칸을 나누고, 둘째 줄에 하이픈(-)으로 구분선을 긋습니다. 문제는 손으로 맞추는 순간 고통이 시작된다는 것입니다. 칸 하나 늘리면 아래 줄이 다 밀리고, 한글이 섞이면 너비가 안 맞아 소스가 엉망이 됩니다.

그런데 표로 만들 데이터는 대개 이미 어딘가에 있습니다 — 엑셀 시트, CSV 파일, 혹은 예전에 만든 마크다운 표. 이 도구는 그걸 붙여넣기만 하면 정렬된 마크다운 표로 바꿉니다. 스프레드시트에서 셀 범위를 복사하면 탭으로 구분되는데, 그대로 붙여넣으면 됩니다.

붙여넣기 (엑셀에서 복사 — 탭 구분):
이름    점수
홍길동  95
김철수  88

결과:
| 이름   | 점수 |
| :----- | :--- |
| 홍길동 | 95   |
| 김철수 | 88   |

구분자를 알아서 감지한다

데이터가 어떻게 구분됐는지는 출처마다 다릅니다. 이 도구는 ‘자동’에서 순서대로 판단합니다 — 탭이 있으면 탭(엑셀·구글시트 복사), 파이프가 많으면 파이프(기존 마크다운 표를 다시 정렬하는 경우), 그 밖이면 쉼표(CSV). 쉼표 데이터에서는 따옴표로 감싼 셀 안의 쉼표 ("서울, 대한민국")를 한 칸으로 지켜, 주소·문장이 쪼개지지 않게 합니다.

물론 자동이 애매하면 구분자를 직접 골라 강제할 수 있습니다.

표가 조용히 깨지는 두 지점

마크다운 표는 규칙이 엄격해서, 다음 둘을 처리하지 않으면 렌더할 때 무너집니다. 이 도구는 둘 다 자동으로 막습니다.

• 셀 안의 파이프 — |는 열을 나누는 문자입니다. 셀 내용에 “a|b”가 있으면 열이 하나 더 생긴 것처럼 표가 어긋납니다. 이 도구는 \|로 이스케이프해 글자 그대로 보이게 합니다.
• 들쭉날쭉한 행 — 어떤 줄은 칸이 3개인데 어떤 줄은 2개면, 마크다운 렌더러가 표를 제대로 못 그립니다. 가장 긴 줄에 맞춰 빈 칸을 채워 칸 수를 통일합니다.

정렬과 헤더

마크다운 표의 정렬은 구분선의 콜론으로 정합니다 — :--- (왼쪽), :--: (가운데), ---: (오른쪽). 숫자 열은 오른쪽 정렬이 읽기 좋습니다. 이 도구에서 정렬을 고르면 그 마커를 넣어 주고, GitHub·노션 같은 GFM(GitHub Flavored Markdown) 지원 환경에서 그대로 적용됩니다.

마크다운 표는 헤더가 필수입니다(구분선 위에 반드시 한 줄이 있어야 합니다). 그래서 ‘첫 줄을 헤더로’ 옵션을 끄면 열1·열2 같은 임시 헤더를 만들어 줍니다 — 결과에서 이름만 바꾸면 됩니다.

정리하면

• 붙여넣으면 끝입니다. 엑셀(탭)·CSV(쉼표)·기존 표(파이프)를 자동으로 알아챕니다.
• 깨질 자리를 미리 막습니다. 셀 안 파이프는 이스케이프, 들쭉날쭉한 행은 빈 칸으로 채웁니다.
• 사람이 읽는 표가 목적입니다. 열 너비를 맞춰 소스에서도 표처럼 보이게 하고, GFM 정렬을 지원합니다.