Markdown 테이블은 HTML 테이블로 렌더링되는 가독성 있는 형식으로 구조화된 데이터를 표시할 수 있습니다. 이 가이드 는 전체 GFM (GitHub 맛있는 Markdown) 테이블 문법, 정렬 옵션, 고급 패턴, Word 테이블을 Markdown로 변환하는 방법.
기본 테이블 문법
Markdown 테이블은 세 부분으로 구성됩니다:
- 헤더 행 열 명칭
- 분리기 줄 파이프와 함께 dashes, 테이블을 정의
- 데이터 행 내용
| Column 1 | Column 2 | Column 3 |
|---|---|---|
| Row 1, Col 1 | Row 1, Col 2 | Row 1, Col 3 |
| Row 2, Col 1 | Row 2, Col 2 | Row 2, Col 3 |이렇게 표현합니다:
| 1번 열 | 2번 열 | 3번 열 |
|---|---|---|
| 1번 줄, 1번 줄 | 1번 줄, 2번 줄 | 1번 줄, 3번 줄 |
| 2번 줄, 1번 줄 | 2번 줄, 2번 줄 | 2번 줄, 3번 줄 |
기둥 정렬
정렬을 제어하기 위해 분리 줄에서 두각을 사용한다.
| Left aligned | Center aligned | Right aligned |
|:---|:---:|---:|
| text | text | text |
| longer text | longer text | longer text || 좌측 정렬 | 중앙 정렬 | 오른쪽 정렬 |
|---|---|---|
| text | text | text |
| 더 긴 텍스트 | 더 긴 텍스트 | 더 긴 텍스트 |
:---왼쪽 정렬 (기본):---:중앙 정렬---:오른쪽 정렬
테이블 셀 안의 포맷
대부분의 인라인 Markdown 포맷은 테이블 셀 안에서 작동합니다:
| Element | Example |
|---|---|
| Bold | **bold text** |
| Italic | *italic text* |
| Code | `inline code` |
| Link | [click here](https://wordtomd.org) |
| Strikethrough | ~~deleted~~ |작동하지 않는 것: 다선 콘텐츠, 둥글고 있는 목록, 블록 레벨 요소.
세포의 파이프 문자
말 그대로 파이프가 필요하다면 | 세포 내부에서, 반사선으로 탈출합니다.
| Flag | Description |
|---|---|
| `x \| y` | Bitwise OR operator |거리가 없는 테이블
파이프 주변 거리를 설정하는 것은 선택 사항입니다. 이것은 유효합니다.
|Column 1|Column 2|
|---|---|
|Cell|Cell|하지만 일관된 간격은 표를 더 쉽게 읽을 수 있게 합니다. 대부분의 편집자와 린터는 간격 형식을 선호합니다.
빈 셀
빈 셀을 위해 파이프 사이의 공간을 비어 두십시오.
| A | B | C |
|---|---|---|
| content | | content |
| | content | |Word 테이블을 Markdown로 변환
Word 테이블을 사용했을 때 자동으로 변환 WordToMD. The converter handles:
- 표준 그리드 → GFM 파이프 테이블
- 열 너비 → 표준화 (Markdown는 열 너비를 제어하지 않습니다)
- 셀 내부의 텍스트 형식화 → 보존 (간근, 간행, 링크)
어떤 것이 전환되지 않는가?
- 합성된 세포 (colspan/rowspan) 가장 가까운 세포로 붕괴
- 다중 줄 셀 함수 줄 단절 단절
- 안쪽 테이블은 평평한
복잡한 Word 테이블 처리
합병 된 세포
Word의 합병 세포는 Markdown에 해당하지 않습니다. 옵션:
- 구조조정 합병된 행을 분리된 테이블로 나누기
- HTML를 사용 대부분의 Markdown 프로세서는 HTML 테이블 문법을 받아들인다:
<table>
<tr>
<th colspan="2">Merged Header</th>
</tr>
<tr>
<td>Cell 1</td>
<td>Cell 2</td>
</tr>
</table>여러 줄의 셀 컨텐츠
사용 <br> 셀 내부의 라인 틈 ( GitHub 및 대부분의 플랫폼에서 작동)
| Step | Description |
|---|---|
| 1 | Open the file<br>Make sure it's .docx format |
| 2 | Drop it on [WordToMD](/#converter) |큰 테이블
많은 열을 가진 테이블의 경우, 테이블이 올바른 형식인지 여부를 고려하십시오. 대안:
- 정의 목록 (기명 + 설명)
- 범주별로 여러 개의 작은 테이블
- 구조화된 데이터의 코드 블록 (JSON, YAML)
플랫폼별 표 렌더링
| 플랫폼 | GFM 표 | 정렬 | HTML 표 |
|---|---|---|---|
| GitHub | ✅ | ✅ | ✅ |
| GitLab | ✅ | ✅ | ✅ |
| Notion | ✅ | ❌ | ❌ |
| Obsidian | ✅ | ✅ | ✅ |
| GitBook | ✅ | ✅ | ✅ |
| VS 코드 미리보기 | ✅ | ✅ | ✅ |
| Confluence (Markdown 매크로) | ✅ | ✅ | ✅ |
| 제킬/후고/아스트로 | ✅ | ✅ | ✅ |
접근성
더 나은 접근성을 위해, 테이블에는 의미있는 열 이름을 가진 헤더 행이 있는지 확인하십시오. 스크린 리더는 헤더 행을 사용하여 셀 컨텍스트를 발표합니다.
| Product | Price | Availability |
|---|---|---|
| Widget A | $9.99 | In stock |
| Widget B | $14.99 | Out of stock |레이아웃 목적으로 테이블을 사용하지 마십시오. 실제 테이블 데이터에만 사용하십시오.
FAQ
왜 내 테이블 렌더링이 일반 텍스트로 표시되지 않는가?
분할 줄 ( |---|---| 라인) 은 필수입니다. 그 없이는 파저는 테이블 구조를 인식하지 못할 것입니다.
헤더 라인이 없는 테이블을 줄 수 있나요?
표준 GFM에서는 아닙니다. 헤더 라인과 분리자가 필요합니다. 가시적인 헤더를 원하지 않으면 빈 헤더를 사용하세요. | | | 분리줄이 있는
왜 Word에서 내 테이블은 WordToMD에서 맞지만 다른 곳에 붙인 후에 잘못 보입니까? 문제는 보통 세포의 백공간이나 불일치한 파이프 문자를 추적하는 것입니다. 대부분의 Markdown 렌더러는 양보적이지만, 복사-동료는 보이지 않는 문자를 도입할 수 있습니다.
어떻게 데이터를 통해 테이블을 프로그래밍할 수 있을까요?
도서관과 같은 markdown-table (npm) 또는 Pythons tabulate 배열에서 Markdown 테이블을 생성할 수 있습니다. 이것은 CSV 또는 데이터베이스 데이터를 대량 변환하는 데 유용합니다.
관련 가이드
- Markdown 는 무엇 입니까? Markdown 기본
- Markdown 문법 빠른 참조표 전체 문법 참조
- Word를 Markdown로 변환하는 방법 전체 변환 가이드
- DOCX에서 Markdown까지 테이블 변환에 집중
결론
Markdown 테이블은 구조화된 데이터를 표시하는 데 강력하며 모든 주요 플랫폼에서 널리 지원됩니다. Word로 시작하는 테이블의 경우, WordToMD 자동으로 GFM 문법으로 변환합니다. 복잡한 레이아웃을 위해, HTML 백백과 위의 트릭은 당신이 필요로하는 제어 기능을 제공합니다.