Skip to content

fix: 노션 테이블 렌더링 깨짐 해결 (구분선 행 생성)#35

Merged
seongyeon1 merged 2 commits into
mainfrom
fix/notion-table-rendering
Jun 18, 2026
Merged

fix: 노션 테이블 렌더링 깨짐 해결 (구분선 행 생성)#35
seongyeon1 merged 2 commits into
mainfrom
fix/notion-table-rendering

Conversation

@hank-kim97

@hank-kim97 hank-kim97 commented Jun 18, 2026

Copy link
Copy Markdown
Contributor

배경

노션 원문의 표가 웹에서 표가 아니라 | 문자가 든 한 줄 문단으로 렌더링되던 문제(#34)를 해결합니다.

원인

scripts/notion-publish.py 의 노션→마크다운 변환에 테이블 구분선(| --- | --- |) 생성 로직이 없었음. 노션 API는 표를 table(메타: table_width) → table_row(자식) 구조로 내려주는데, table 블록 핸들러가 없어 table_row| 셀 | 로 출력되고 구분선이 빠졌습니다. 마크다운/MDX는 구분선이 있어야 표로 인식하므로 평범한 문단으로 렌더됐습니다.

변경

1. fix(publish) — 파이프라인 수정

  • _blocks_to_mdtable 블록 핸들러 추가
  • 헤더 행 다음에 table_width 기반 구분선 삽입
  • 표 앞뒤 빈 줄로 감싸 인접 문단과 분리
  • 셀 내 |\| 로 이스케이프
  • 자식 table_row 직접 처리 후 continue 로 중복 재귀 차단

2. fix(blog) — 기존 글 백필

  • 이미 깨진 채 발행된 5개 글 9개 표 일괄 수정 (전부 기존 파일 수정, 신규 생성 아님)

전/후 비교

  • 이전
image
  • 이후
image

검증

  • ✅ 프로덕션 빌드 성공 (Generated static files, 에러 없음)
  • ✅ 생성된 정적 HTML에서 표 9개 전부 <table>/<th>/<td> 로 렌더링
  • ✅ 전체 글 스캔 결과 구분선 누락 표 0개
  • ✅ 변환 함수 단위 테스트 통과 (구분선 생성·파이프 이스케이프·빈 줄 분리)

Closes #34

🤖 Generated with Claude Code

Taehan Hank Kim and others added 2 commits June 18, 2026 09:43
_blocks_to_md 에 table 블록 핸들러를 추가해 헤더 행 다음에
table_width 기반 구분선(| --- | --- |)을 삽입한다. 그동안 table_row 만
처리하고 구분선을 넣지 않아 표가 | 문자 든 문단으로 렌더링되던 문제를 해결.

- 표 앞뒤를 빈 줄로 감싸 인접 문단과 분리
- 셀 내 | 는 \| 로 이스케이프해 열 깨짐 방지
- 자식 table_row 는 직접 처리하고 continue 로 중복 재귀 차단

Refs #34

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
발행 파이프라인 버그로 구분선 없이 저장돼 깨져 있던 표를 일괄 수정한다.
5개 글 9개 표가 대상이며, 각 표 헤더 다음에 구분선 행을 삽입하고
표 앞뒤를 빈 줄로 분리했다.

Refs #34

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@seongyeon1 seongyeon1 merged commit 1a0de76 into main Jun 18, 2026
@seongyeon1 seongyeon1 deleted the fix/notion-table-rendering branch June 18, 2026 00:50
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

노션 발행 파이프라인이 테이블을 표로 렌더링하지 못함 (구분선 행 누락)

2 participants