Markdown 표 완전 가이드 (GFM)
실제 문서에서 작동하는 Markdown 표의 완전 가이드. GitHub Flavored Markdown (GFM) 구문, 정렬, 셀 내 링크/이미지/코드, 여러 줄 셀, 그리고 CSV/Excel ⇄ Markdown 간의 변환을 다룹니다.
팁: 편집기에서 표 사용해보기 버튼을 사용하여 실시간 미리보기로 완벽한 표를 만들고 DOCX/PDF로 내보내어 실제 Word 표(테두리와 정렬 유지)를 얻으세요.
목차
- 기본 구문
- 정렬
- 셀 내 링크, 이미지, 코드
- 여러 줄 셀
- 열 너비와 줄 바꿈
- CSV / Excel ⇄ Markdown
- HTML 표(Markdown이 부족할 때)
- 플랫폼 차이
- 자주 묻는 질문
기본 구문
| 기능 | 지원 |
|------|------|
| 표 | ✅ |
| 정렬 | ✅ |
- 첫 번째 줄은 헤더입니다.
- 두 번째 줄의 대시가 표를 정의하고 정렬 마커를 지원합니다.
정렬
| 왼쪽 정렬 | 중앙 정렬 | 오른쪽 정렬 |
|:----------|:----------|:-------------|
| 내용 | 내용 | 내용 |
:---= 왼쪽 정렬,:---:= 중앙 정렬,---:= 오른쪽 정렬.
셀 내 링크, 이미지, 코드
| 타입 | 예제 |
|------|--------------------------------|
| 링크 | [md2word](https://md2word.com) |
| 이미지|  |
| 코드 | `인라인 코드` |
블록 요소(목록, 인용 블록)는 다른 파서에서 셀 내에서 신뢰성 있게 지원되지 않습니다 — 각 셀 내용을 간결하게 유지하세요.
여러 줄 셀
CommonMark 자체는 셀 내 하드 줄 바꿈을 지원하지 않지만, 많은 렌더러가 <br>을 수락합니다:
| 기능 | 설명 |
|------|--------------------------|
| 여러 줄 | 1행<br>2행<br>3행 |
긴 내용의 경우 줄을 나누거나 정확한 레이아웃을 위해 HTML 표로 전환하는 것을 고려하세요.
열 너비와 줄 바꿈
Markdown에는 네이티브 열 너비 제어가 없습니다. 고정 너비의 경우 CSS/HTML을 사용하세요. md2word를 통해 내보낼 때, 열은 Word 표처럼 자동으로 조정되고 정렬/테두리를 유지합니다.
CSV / Excel ⇄ Markdown
CSV → Markdown
- CSV를 변환기에 붙여넣습니다.
- "CSV → Markdown 표"를 선택합니다.
- 정렬을 조정; DOCX/PDF로 복사하거나 내보냅니다.
Markdown → CSV/Excel
- 감지된 표를 스프레드시트 편집을 위해 CSV 또는 .xlsx로 내보냅니다.
CSV 예제:
이름,점수,합격
김철수,92,TRUE
이영희,78,TRUE
박민준,63,FALSE
변환된 Markdown:
| 이름 | 점수 | 합격 여부 |
|--------|------:|:---------:|
| 김철수 | 92 | ✅ |
| 이영희 | 78 | ✅ |
| 박민준 | 63 | ❌ |
HTML 표(Markdown이 부족할 때)
rowspan/colspan, 정확한 너비, 또는 중첩된 내용이 필요할 때 HTML을 사용하세요:
<table>
<thead>
<tr><th>분기</th><th colspan="2">수익</th></tr>
</thead>
<tbody>
<tr><td>1분기</td><td>$1.2M</td><td>$1.4M</td></tr>
</tbody>
</table>
md2word는 HTML 표를 셀 병합 기능이 있는 실제 Word 표로 변환합니다.
플랫폼 차이
| 플랫폼 | 표 | 정렬 | 설명 |
|---|---|---|---|
| GitHub (GFM) | ✅ | ✅ | 가장 일반적; colspan/rowspan 지원 안 함 |
| Obsidian | ✅ | ✅ | 미리보기에서 작동; 내보내기는 플러그인 의존 |
| Notion | ⚠️ | ⚠️ | Markdown을 가져오지만 네이티브 표 사용 |
| Discord/Reddit | ⚠️ | ⚠️ | 지원 제한 또는 없음; 스크린샷 또는 코드 블록 고려 |
자주 묻는 질문
Q: 왜 내 열이 일반 텍스트 편집기에서 정렬되지 않아 보이나요? 공백은 순수하게 장식적입니다. 렌더링 엔진은它们을 무시합니다; 헤더 행에서 정렬 마커를 사용하세요.
Q: 셀을 병합할 수 있나요?
순수 Markdown에서는 안 됩니다. rowspan/colspan에는 HTML 표를 사용하거나 데이터를 재구성하세요.
Q: Word에 복사 붙여넣기할 때 표 서식이 깨집니다 md2word 내보내기를 사용하여 일관된 테두리와 정렬이 있는 적절한 DOCX 표를 얻으세요.
Q: 표는 얼마나 클 수 있나요? Markdown 파서는 큰 표를 처리할 수 있지만 브라우저가 느려집니다. 분할하거나 편집을 위해 CSV/Excel로 전환했다가 다시 내보내는 것을 고려하세요.
변경 로그
- 2025-10-16: 한국어 버전 출시, 양방향 CSV/Excel 변환 및 HTML 대체 가이드 지원.
다음 단계:
- 편집기에서 표 사용해보기를 사용하여 실시간 미리보기와 내보내기 기능으로 표를 만드세요.
- 관련 문서 탐색: Markdown 치트시트, Markdown 하이퍼링크, Markdown에서 PDF.