AI가 만든 Markdown 표에서 열이 어긋날 때: 셀 안의 세로줄부터
AI가 만든 표를 붙였는데 열이 하나 더 생기거나 설명이 잘렸다면, 셀 안에 들어간 |부터 살펴보세요. Markdown 표에서는 이 기호가 열 경계를 나누는 역할을 할 수 있습니다. 표의 내용이 맞는지와 표 문법이 맞는지는 따로 확인해야 합니다.
GitHub Markdown 표에서는 내부 세로줄 앞에 역슬래시를 붙인 A\|B로 표현합니다. 마지막 판단은 실제 게시할 곳의 미리보기에서 합니다.
1. 공식 문서에서 확인한 범위
GitHub의 표 작성 안내는 세로줄과 하이픈으로 표를 만들며, 표 앞에는 빈 줄을 두도록 설명합니다. 셀 내용으로 세로줄을 넣으려면 그 앞에 역슬래시를 붙입니다. 이 설명의 적용 범위는 GitHub에서 쓰는 Markdown 표입니다.
모든 블로그 편집기가 Markdown을 같은 방식으로 해석하는 것은 아닙니다. HTML 편집기에 Markdown 문자열만 붙이면 표 대신 기호가 그대로 보일 수도 있습니다. 글을 올릴 편집기의 지원 형식을 먼저 확인한 뒤 그 형식에 맞게 옮기세요.
2. 두 열짜리 독립 예시
아래는 선택지 이름에 세로줄이 포함된 경우를 위한 자체 예시입니다. 목적은 선택지와 설명을 두 열로 유지하는 것입니다.
| 선택지 | 설명 | | --- | --- | | A\|B | 같은 묶음의 이름 |
의도한 결과를 읽기 편한 표로 나타내면 다음과 같습니다. 위 소스의 역슬래시는 표시할 글자의 일부가 아니라 내부 세로줄을 구분하기 위한 문법입니다.
| 선택지 | 설명 |
|---|---|
| A|B | 같은 묶음의 이름 |
이 본문 표는 HTML로 구성했습니다. 독자가 결과의 두 열을 비교할 수 있도록 제시한 것이며 이 블로그가 Markdown을 자동 변환한다고 주장하지 않습니다.
3. AI에 다시 요청할 때 보존할 것
수정 요청은 “표를 예쁘게 고쳐 줘”보다 “두 열을 유지하고, 셀 내용인 세로줄만 GitHub Markdown 문법에 맞게 이스케이프해 줘. 항목명과 설명은 바꾸지 마”처럼 구체적으로 쓰는 편이 확인하기 쉽습니다. 다만 요청 문장을 썼다고 결과가 자동으로 정확해지는 것은 아닙니다.
다시 받은 표는 원래 항목 수, 열 이름, 숫자와 단위, 링크 목적지부터 대조하세요. 열 정렬을 손보는 과정에서 내용이 삭제되거나 새 설명이 추가되지 않았는지 확인합니다. 문법 수정을 사실 수정으로 확대하지 않는 것이 이 점검의 목적입니다.
4. 발행 전 점검과 FAQ
미리보기에서 머리글 수와 각 행의 셀 수를 비교한 뒤, A|B처럼 기호가 들어간 항목이 하나의 셀 안에 남는지 확인합니다. 긴 링크가 셀 밖으로 밀리는 경우에는 편집기에서 읽기 쉬운 링크 문구를 적용하고 실제 목적지를 확인하세요.
모든 세로줄 앞에 역슬래시를 붙이나요?
아닙니다. 열 경계를 나누는 세로줄까지 바꾸면 표의 구조를 잃을 수 있습니다. 셀 내용으로 남길 세로줄과 경계 기호를 먼저 구분합니다.
AI가 “수정 완료”라고 말하면 확인을 생략해도 되나요?
완료 문구와 실제 렌더링 결과는 다릅니다. 붙일 편집기에서 열 수와 셀 내용을 직접 확인하세요.
근거: GitHub Docs의 표 작성 안내. 예시와 검수 양식은 이 글에서 직접 구성했습니다.
GitHub 공식 표 문법과 세로줄 예시 보기확인 기준일: 2026년 10월 4일.
대표 썸네일은 AI로 제작한 삽화이며, 본문 표 문법 도표는 직접 구성했습니다.
댓글
댓글 쓰기