마크다운 표 만들기 — 문법·정렬과 엑셀에서 옮기는 법

깃허브 README, 노션, 개발 문서 — 표가 필요한 순간은 많은데 마크다운 표 문법은 쓸 때마다 헷갈립니다. 구분선이 몇 개였는지, 정렬 콜론이 어느 쪽이었는지. 기본 문법부터 자주 막히는 부분, 엑셀 데이터를 표로 옮기는 가장 빠른 방법까지 정리합니다.

기본 문법 — 파이프와 구분선

마크다운 표는 세 가지 요소로 이뤄집니다. 머리글 줄, 구분선 줄, 그리고 데이터 줄입니다. 칸은 파이프(|)로 나눕니다.

| 이름   | 가격  |
|--------|-------|
| 아메리카노 | 4,500 |
| 라떼   | 5,000 |

• 구분선 줄이 필수입니다 — 머리글 바로 아래 |---|---| 줄이 있어야 표로 인식됩니다. 하이픈은 3개 이상이면 됩니다.
• 칸 너비는 안 맞춰도 됩니다 — 렌더러는 파이프 개수만 봅니다. 너비 정렬은 원본 가독성을 위한 선택 사항입니다.
• 양 끝 파이프는 생략 가능 — 다만 붙이는 쪽이 표임을 알아보기 쉬워 권장됩니다.

정렬 — 콜론의 위치

구분선의 하이픈 양쪽에 콜론(:)을 붙여 칸 정렬을 지정합니다.

• :--- — 왼쪽 정렬(기본값과 동일)
• :---: — 가운데 정렬
• ---: — 오른쪽 정렬 (숫자·금액 칸에 좋습니다)

자주 막히는 것들

• 셀 안의 파이프: \| 로 이스케이프하세요. 코드 표기(백틱) 안이라도 표 구분자로 해석하는 렌더러가 많습니다.
• 셀 안 줄바꿈: 표준 문법에는 없습니다. 깃허브 등 HTML 허용 환경에서는 <br> 태그로 가능합니다.
• 셀 병합: 마크다운 표는 지원하지 않습니다. 꼭 필요하면 HTML <table>로 작성해야 합니다.
• 빈 칸: 파이프 사이를 비워 두면 됩니다 — | 값 | | 처럼 칸 자체는 유지해야 줄이 어긋나지 않습니다.

엑셀·CSV에서 옮기기

이미 엑셀·구글 시트에 있는 데이터를 손으로 다시 칠 필요는 없습니다. 변환 도구를 쓰면 복사–붙여넣기 한 번으로 끝납니다.

1. 엑셀·구글 시트에서 표 범위를 복사합니다 (칸은 탭으로 구분되어 복사됩니다).
2. 표 변환기에 붙여 넣으면 자동으로 표로 인식됩니다.
3. 출력 형식을 '마크다운'으로 고르고, 필요하면 열 정렬을 지정합니다.
4. 변환된 표를 복사해 README·노션·문서에 붙여 넣습니다.