Markdown 표 만들기

Markdown 표 만드는 방법

일반 텍스트로도 읽기 쉬운 작은 문서 표, README 비교, 업데이트 안내용입니다.

1. 스프레드시트의 직사각형 영역을 복사해 데이터 입력란에 붙인 뒤 격자 교체를 누르세요. Tab은 열, 줄바꿈은 행을 나누며 첫 행은 머리글입니다.
2. 격자의 모든 셀을 확인하세요. 격자 셀에 여러 셀을 직접 붙이면 100행·20열 제한 안에서 그 위치부터 확장됩니다.
3. 필요한 행·열을 추가·삭제하고 열마다 왼쪽·가운데·오른쪽 정렬을 정하세요. 행 정렬은 본문만 바꾸어 머리글은 맨 위에 남습니다.
4. 생성 원본과 안전한 미리보기를 비교하세요. 행 수, 제목, 정렬, 값이 맞으면 Markdown을 복사해 README·이슈·위키·편집기에 붙이세요.

생성 문법의 원리

일반 Markdown 표는 파이프로 셀을 구분합니다. 첫 줄은 머리글, 둘째는 대시 구분 행입니다. :---는 왼쪽, :---:는 가운데, ---:는 오른쪽 정렬이며 나머지는 본문 행입니다.

원본을 읽기 쉽게 셀에 공백을 채웁니다. 일반 렌더러에서 이 공백은 값을 바꾸지 않습니다. 빈 셀도 유지해 모든 행의 열 수를 맞춥니다.

셀 내부 파이프는 \|로 써 열 경계와 구별합니다. 일반 GFM 표에는 널리 통용되는 여러 줄 셀 문법이 없어 실제 줄바꿈은 <br>로 바꿉니다. 역슬래시를 먼저 이스케이프한 뒤 파이프를 처리합니다.

미리보기는 Markdown을 실행하지 않고 텍스트 노드의 HTML 표를 만듭니다. 형태·값·정렬 확인에 유용하지만 GitHub, 정적 사이트, 위키, 다른 문법의 최종 표시와 다를 수 있습니다.

풀이 예시

| Task | Owner | Status |
| :--- | :--- | :---: |
| Docs | Ada | Ready |

| 지표 \| 보기 | 메모 |
| :--- | :--- |
| 계획 \| 실적 | 첫 줄<br>둘째 줄 |

유용한 용도

기능 비교, 환경 표, 단축키 참고, 배포 체크리스트, 버전 관리 차이에서 검토하기 쉬운 작은 요약에 쓰세요.

스프레드시트 범위를 붙이거나 제목·값이 몇 개뿐이면 격자를 직접 편집하세요.

정렬은 표시 보조이며 계산이 아닙니다. 자연 정렬로 Item 2가 Item 10보다 먼저, 빈 값은 마지막에 옵니다.

제한과 해결 방법

• 평면 표만 지원합니다. Markdown에는 병합 셀·행·열 병합의 널리 호환되는 문법이 없습니다.
• 가져오기는 Tab 구분을 기대합니다. 따옴표 쉼표·내부 줄바꿈이 있는 CSV는 스프레드시트에서 열어 셀을 복사하세요.
• 100행, 20열, 셀당 2,000자까지입니다. 큰 데이터는 목적별 표로 나누세요.
• 인라인 Markdown은 출력에 남지만 이 미리보기에서는 해석하지 않습니다. 게시 렌더러에서 확인하세요.
• 앞뒤 공백을 제거하므로 그 공백이 중요한 데이터에는 적합하지 않습니다.

결과 복사와 확인

일반 텍스트로 복사·붙여넣으세요. 클립보드가 막히면 코드를 직접 선택하세요. 업로드·저장하지 않으므로 닫기 전에 보관하세요.

대상 환경이 GFM 파이프 표·<br>를 지원하는지 확인하세요. 미리보기는 형태·값을 검사하며 모든 렌더러의 동일한 스타일을 보장하지 않습니다.

자주 묻는 질문