테이블 — 파이프, 정렬, 그리고 한계 · Markup Quest

파이프가 컬럼 그리고, 대시가 헤더 라인 그린다

GFM 테이블은 조각 세 개로 이뤄져. 헤더 행, 대시로 된 구분 행, 그리고 본문 행 (몇 줄이든). 컬럼을 나누는 건 파이프 (|) 야. 양 끝 파이프는 붙여도 되고 말아도 되고, 공백은 얼마든 봐줘.

정렬은 구분 행에 산다

:--- — 왼쪽 정렬 (기본)
:---: — 가운데
---: — 오른쪽 정렬 (숫자 컬럼에 써)

셀이 담을 수 있는 것

셀은 inline Markdown 을 다 받아. bold, italic, code, link, inline HTML 까지 들어가. 대신 블록 컨텐츠는 못 담아. 헤딩, 리스트, fenced code block, 문단은 안 들어가. 그게 꼭 필요하면 테이블 자체를 HTML 로 써.

셀 안의 파이프

\| 로 escape 하면 돼. 코드 안의 파이프를 그대로 보여주고 싶으면 <code>|</code> 로 감싸도 되고. 렌더러는 둘 다 알아들어.

'예쁜 소스' 함정: 에디터나 포매터가 셀 폭을 맞추려고 공백을 알아서 채워. 렌더러 입장에선 아무 상관 없는데 diff 에선 악몽이야. 셀 하나 폭이 바뀌면 모든 행이 다시 쓰이거든. 그래서 둘 중 하나를 골라야 해. 손으로 정렬을 맞춰서 깔끔한 diff 를 챙기든가, 테이블 한 번 고칠 때마다 노이즈 commit 이 붙는 걸 받아들이든가.

Code

최소 유효 테이블·markdown

| Header 1 | Header 2 |
| --- | --- |
| Row 1 | Cell |
| Row 2 | Cell |

정렬 (왼쪽 / 가운데 / 오른쪽)·markdown

| Name | Status | Count |
| :--- | :---: | ---: |
| alpha | ok | 12 |
| beta | warn | 3,481 |
| gamma | error | 7 |

셀 안 inline Markdown (허용)·markdown

| Feature | Spec | Notes |
| --- | --- | --- |
| **Bold** | CM | works in cells |
| `code` | CM | works |
| [link](https://example.com) | CM | works |
| ![img](pic.png) | CM | also works |

셀 내용에서 파이프 escape·markdown

| Pattern | Meaning |
| --- | --- |
| `a \| b` | literal pipe in code |
| `a` \| `b` | two code spans, separated |

Exercise

최근에 만진 CSV 파일 하나 골라봐 (env vars 든 dependency 목록이든, 표 모양이면 뭐든). GFM 테이블로 옮기고 숫자 컬럼은 오른쪽으로 정렬해. 그 다음 셀에 여러 줄짜리 값이나 fenced code block 을 억지로 넣어보고 파서가 거부하는 걸 직접 봐. 여기서 배울 건 우회법이 아니라 한계 그 자체야.

테이블 — 파이프, 정렬, 그리고 한계

파이프가 컬럼 그리고, 대시가 헤더 라인 그린다

정렬은 구분 행에 산다

셀이 담을 수 있는 것

셀 안의 파이프

Code

External links

Exercise

Progress

댓글 0