마크다운 표 문법 완전정복

마지막 업데이트: 2026-06-25

한줄 요약

마크다운 표는 세로줄(|)로 셀을 구분하고, 머리글 바로 아래에 하이픈(---) 구분선을 두는 구조입니다.

구분선에 콜론(:)을 붙여 열 정렬을 지정하고, 셀 안의 세로줄은 \| 로 이스케이프합니다.

1. 마크다운 표의 기본 구조

마크다운 표는 최소 세 가지 요소로 이루어집니다. 첫째 줄은 머리글(헤더), 둘째 줄은 구분선, 셋째 줄부터는 본문 데이터입니다. 각 셀은 세로줄(|)로 구분하며, 줄 양 끝의 세로줄은 있어도 없어도 됩니다.

| 이름 | 나이 | 도시 |
| --- | --- | --- |
| 홍길동 | 30 | 서울 |
| 김영희 | 25 | 부산 |

핵심은 둘째 줄의 구분선입니다. 머리글 바로 아래에 각 열마다 최소 세 개의 하이픈(---)을 두어야 마크다운 렌더러가 이 블록을 표로 인식합니다. 구분선이 빠지면 표가 아니라 일반 텍스트로 표시됩니다.

2. 열 정렬 지정하기

구분선 줄에 콜론(:)을 붙여 각 열의 정렬을 지정할 수 있습니다. 콜론의 위치에 따라 정렬 방향이 달라집니다.

구분선 표기와 정렬
표기	정렬
`:---`	왼쪽 정렬
`:---:` 또는 `:-:`	가운데 정렬
`---:`	오른쪽 정렬
`---`	기본값(렌더러에 따라 보통 왼쪽)

| 항목 | 수량 | 금액 |
| :--- | :-: | ---: |
| 사과 | 3 | 4,500 |
| 배 | 1 | 3,000 |

위 예시에서 "항목"은 왼쪽, "수량"은 가운데, "금액"은 오른쪽으로 정렬됩니다. 숫자 열은 오른쪽 정렬로 두면 자릿수가 맞아 읽기 편합니다.

3. 셀 안에 특수 문자 넣기 (이스케이프)

셀 내용에 세로줄(|)이 들어가면 마크다운이 이를 열 구분 문자로 오해해 표가 깨집니다. 이때는 세로줄 앞에 역슬래시를 붙여 \| 로 이스케이프합니다. 예를 들어 "A 또는 B"를 "A | B"로 쓰고 싶다면 셀에 A \| B 라고 입력합니다. 텍스트툴의 마크다운 표 생성기는 셀 안의 세로줄을 자동으로 이스케이프해 줍니다.

4. 셀 줄바꿈과 인라인 서식

마크다운 표 셀 안에서는 엔터키로 줄을 바꿀 수 없습니다. 셀 내용을 두 줄로 표시하려면 <br> 태그를 셀에 넣으면 됩니다. 또한 셀 안에서도 굵게(**굵게**), 기울임(*기울임*), 인라인 코드(`코드`), 링크([텍스트](URL)) 같은 인라인 서식을 그대로 사용할 수 있습니다.

5. 표가 깨질 때 점검 목록

구분선 확인 — 머리글 바로 아래에 | --- | --- | 형태의 구분선이 있는지 확인합니다. 가장 흔한 실수입니다.
열 개수 일치 — 가능하면 모든 행의 세로줄 개수를 머리글과 맞춥니다. 셀이 모자라면 빈 셀(| |)로 채웁니다.
세로줄 이스케이프 — 셀 내용의 |를 \|로 바꿨는지 확인합니다.
빈 줄 분리 — 표 위아래에 빈 줄을 한 줄씩 두면 일부 렌더러에서 인식이 더 안정적입니다.
탭 대신 세로줄 — 스프레드시트에서 복사한 탭 구분 데이터는 표로 인식되지 않으므로 세로줄 형식으로 변환해야 합니다. 변환은 마크다운 표 생성기로 자동 처리할 수 있습니다.

6. 어디에 붙여넣을 수 있나

마크다운 표는 GitHub README, 노션, Obsidian, GitLab, 디스코드, 그리고 마크다운을 지원하는 정적 블로그 대부분에서 동작합니다. 다만 셀 병합(rowspan/colspan)은 표준 마크다운에서 지원하지 않으므로, 복잡한 표가 필요하면 HTML 표 태그를 직접 쓰거나 표를 여러 개로 나누는 방법을 고려해야 합니다.

자주 묻는 질문 (FAQ)

마크다운 표에서 셀 줄바꿈은 어떻게 하나요?

마크다운 표 셀 안에서는 엔터로 줄바꿈을 할 수 없습니다. 대신 <br> 태그를 셀 내용에 넣으면 GitHub·노션 등 대부분의 렌더러에서 줄바꿈으로 표시됩니다.

표가 깨져 보이는 가장 흔한 원인은 무엇인가요?

가장 흔한 원인은 머리글 바로 아래 구분선(--- 줄)을 빠뜨린 경우와, 셀 안의 세로줄(|)을 이스케이프하지 않은 경우입니다. 구분선이 없으면 표로 인식되지 않고, 이스케이프하지 않은 세로줄은 열을 잘못 나눕니다.

셀 정렬은 어떻게 지정하나요?

구분선 줄에 콜론을 붙여 정렬을 지정합니다. :--- 는 왼쪽, :-: 는 가운데, ---: 는 오른쪽 정렬입니다. 콜론이 없으면 렌더러 기본값(보통 왼쪽)을 따릅니다.