마크다운 표 만들기: 정렬, 줄바꿈, 병합까지

마크다운 표는 기본 문법 자체는 쉬운데, 조금만 욕심을 내면 바로 벽에 부딪힙니다. 숫자를 오른쪽에 붙이고 싶을 때, 셀 안에서 줄을 바꾸고 싶을 때, 셀을 병합하고 싶을 때. 이 글은 표를 그리다 막히는 지점만 골라서 되는 것은 하는 법을, 안 되는 것은 대안을 정리했습니다.

최종 업데이트: 2026년 7월

1. 기본 문법 1분 복습

세로줄 |로 칸을 나누고, 머리글 바로 아래 줄에 --- 구분선을 넣으면 표가 됩니다.

| 이름 | 담당 | 비고 |
| --- | --- | --- |
| 김민준 | 디자인 | 시안 2종 |
| 이서연 | 개발 | 마감 금요일 |

기억할 규칙은 세 가지뿐입니다.

• 구분선 줄은 필수입니다. 이 줄이 없으면 표가 아니라 그냥 세로줄 섞인 문장으로 렌더링됩니다.
• 구분선의 -는 한 칸에 1개 이상이면 됩니다. ---든 -든 결과는 같습니다.
• 소스에서 세로줄을 맞출 필요가 없습니다. 칸 너비가 들쭉날쭉해도 파이프 개수만 맞으면 표는 반듯하게 나옵니다.

2. 정렬: 콜론 위치가 전부

정렬은 구분선 줄에서 - 양옆에 콜론 :을 어디에 붙이느냐로 정합니다. 열 단위로만 지정할 수 있고, 셀마다 다르게 줄 수는 없습니다.

| 품목 | 수량 | 금액 |
| :--- | :---: | ---: |
| 커피 | 2 | 9,000 |
| 샌드위치 | 1 | 6,500 |

숫자 열을 오른쪽 정렬로 바꾸는 것만으로 표가 훨씬 읽기 좋아집니다. 자릿수가 다른 금액이 왼쪽 정렬로 늘어서 있으면 비교가 어렵기 때문입니다.

3. 셀 안에서 줄바꿈하기

표의 한 행은 소스에서 반드시 한 줄이어야 합니다. 셀 안에서 엔터를 치면 표가 거기서 끊어집니다. 셀 안 줄바꿈이 필요하면 HTML 태그 <br>를 씁니다.

| 단계 | 내용 |
| --- | --- |
| 1단계 | 재료 손질<br>양파는 채 썰기 |
| 2단계 | 중불에서 5분 볶기 |

마크다운 안에 HTML을 섞는 게 이상해 보일 수 있지만, 깃허브·노션 내보내기 등 대부분의 렌더러가 표 안의 <br>을 지원하는 사실상의 표준 해법입니다. 다만 줄바꿈이 여러 번 필요할 정도로 셀 내용이 길다면, 그 내용은 표보다 목록이나 문단이 맞는 경우가 많습니다.

4. 세로줄(|)을 글자로 쓰기

셀 내용에 | 문자가 들어가면 칸 구분자로 해석돼 표가 깨집니다. 앞에 역슬래시를 붙여 \|로 쓰면 글자로 표시됩니다.

| 명령 | 뜻 |
| --- | --- |
| a \| b | a 또는 b (파이프 연산) |

코드 스타일(백틱) 안이라도 표 안에서는 이스케이프가 필요한 렌더러가 많으니, 표에 파이프 문자가 들어가면 일단 \|로 쓰는 것이 안전합니다.

5. 셀 병합은 안 됩니다, 대신

마크다운 표에는 셀 병합 문법이 없습니다. 깃허브 방식(GFM) 표준에 없는 기능이라 앞으로도 지원될 가능성은 낮습니다. 병합이 필요한 표라면 선택지는 세 가지입니다.

• 표를 다시 설계: 병합하려던 값을 열 하나로 빼서 반복 표기하는 쪽이 데이터로도 깔끔한 경우가 많습니다. 병합은 시각 장식이지 정보가 아닙니다.
• HTML 표로 전환: 정말 병합이 필요하면 <table>을 직접 쓰고 rowspan·colspan을 지정합니다. 마크다운 문서 안에 HTML 표를 넣는 것은 문법 위반이 아닙니다.
• 표를 나누기: 병합으로 구역을 나누려던 것이라면, 소제목을 달고 표를 두 개로 쪼개는 편이 읽기에도 낫습니다.

6. 자주 묻는 질문

엑셀이나 구글 시트의 표를 마크다운으로 옮기려면요?

손으로 파이프를 치는 것보다, 시트에서 복사한 값이 탭으로 구분된다는 점을 이용해 텍스트 편집기에서 탭을 |로 바꾸고 머리글 아래에 구분선 줄을 추가하는 방법이 빠릅니다. 행이 많다면 "tsv to markdown" 종류의 변환 도구를 쓰는 것도 방법입니다.

열 너비를 지정할 수 있나요?

마크다운 문법으로는 불가능합니다. 너비는 렌더링하는 쪽(깃허브, 블로그 테마 등)의 CSS가 정합니다. 소스에서 공백으로 칸을 아무리 넓혀도 결과에는 반영되지 않습니다.

표 안에 굵게, 링크, 코드도 넣을 수 있나요?

네. **굵게**, [링크](주소), `코드` 같은 인라인 서식은 셀 안에서 그대로 동작합니다. 안 되는 것은 목록, 코드 블록, 인용처럼 여러 줄이 필요한 블록 요소입니다.

머리글 없는 표를 만들 수 있나요?

표준 문법으로는 머리글 행이 필수입니다. 머리글 칸을 비워 두는 것으로 비슷한 효과를 낼 수는 있지만, 렌더러에 따라 빈 머리글 줄이 그대로 보이기도 합니다. 머리글이 정말 필요 없는 데이터라면 목록이 더 맞을 수 있습니다.