먼저 알아둘 기준

기본 Markdown 표는 헤더 행, 구분 행과 데이터 행으로 구성됩니다. 각 열은 | 문자로 나뉘며 구분 행의 콜론 위치로 왼쪽·가운데·오른쪽 정렬을 표현하는 방언도 있습니다.

CSV 셀 안의 |는 Markdown 열 구분자로 오해되므로 역슬래시로 이스케이프해야 합니다. 셀 내부 줄바꿈도 렌더러에 따라 표를 깨뜨릴 수 있어 공백이나 허용된 HTML br로 바꾸는 정책이 필요합니다.

열과 행이 많은 CSV를 전부 표로 만들면 모바일에서 읽기 어렵습니다. 독자에게 필요한 열만 선택하고 긴 메모는 요약하거나 별도 단락으로 옮기는 것이 좋습니다.

실제 작업에서 보는 사례

01

name,price 두 열 CSV를 | name | price | 형태의 표로 만듭니다.

02

‘A|B’ 셀은 ‘A\|B’로 바꿔 하나의 셀로 유지합니다.

03

설명 열이 300자인 상품표는 필요한 길이로 자르거나 설명 열을 제외합니다.

단계별로 확인하는 방법

  1. 1

    CSV 인코딩, 구분자와 첫 행 헤더를 확인합니다.

  2. 2

    표에 보여 줄 열과 행 정렬 기준을 선택합니다.

  3. 3

    파이프, 줄바꿈과 역슬래시가 든 셀의 결과를 점검합니다.

  4. 4

    대상 Markdown 렌더러에서 미리본 뒤 복사하거나 저장합니다.

주의할 점

  • Markdown 구현마다 표와 셀 내부 HTML 지원 범위가 다릅니다.
  • 표가 지나치게 넓으면 모바일 가독성이 떨어지므로 원본 CSV 다운로드를 함께 제공하는 방법도 고려해야 합니다.

기술적 제한

  • CommonMark 핵심 명세에는 표가 없고 렌더러 확장 문법에 의존합니다.
  • 복잡한 셀 콘텐츠와 여러 줄 값은 일반 파이프 표에서 손실 없이 표현하기 어렵습니다.