Skip to content

ELOG 003 note prose typography missing

wcorn edited this page Jun 6, 2026 · 1 revision

ELOG-003: 노트 heading/목록이 일반 텍스트로 보임 (prose 스타일 누락)

항목 내용
분류 🔧 트러블슈팅
날짜 2026-06
영역 FE (Tiptap / Tailwind Typography)
관련 이슈/PR #430, #437
상태 해결

인덱스로 돌아가기: Engineering Log

1. 상황 (Before)

노트 본문에서 ## 제목, 목록, 인용 등이 — 새 페이지든 기존 페이지든, 한글이든 영어든 — 전부 일반 텍스트로만 보였다. 마크다운 단축 입력이 안 먹는 것처럼 보였다.

2. 원인 분석

"마크다운 input rule 버그"로 의심했으나, 코드를 고치기 전에 Tiptap input rule을 실제 타이핑(handleTextInput)으로 재현 테스트했다 → ## 입력 시 <h2> 노드로 정상 변환됨 (HEADING? true). 즉 변환은 처음부터 정상이었다.

진짜 원인은 스타일 누락:

  • NoteEditor는 class="prose prose-sm dark:prose-invert ..."로 본문을 스타일링
  • 그런데 @tailwindcss/typography 플러그인이 설치/등록되어 있지 않았음
  • 빌드된 CSS에 .prose 규칙이 0개 → prose 클래스가 전부 무력화
  • 결과적으로 <h2>가 <p>와 동일하게 렌더 → "텍스트로만 보임"

3. 조치 (#437)

  • @tailwindcss/typography@0.5.19 devDependency 추가
  • index.css에 @plugin "@tailwindcss/typography"; 등록 (Tailwind v4 방식)

4. 결과 (After)

빌드 CSS 검증:

수정 전 수정 후
grep -c '\.prose' dist/assets/*.css 0 prose heading 규칙 생성 (font-size:2.14286em 등) + --tw-prose-* 토큰 + prose-invert 다크

heading/목록/인용이 정상 스타일로 표시됨.

5. 교훈 / 후속

  • 증상 ≠ 원인. "마크다운이 안 변환된다"는 증상이었지만 변환은 정상이었고, 보이지 않은 건 스타일 때문이었다. 코드를 고치기 전에 재현 테스트로 어느 단계가 실패하는지 먼저 격리한 것이 헛수고를 막았다.
  • Tailwind v4에서 prose를 쓰면 @plugin "@tailwindcss/typography" 등록이 필수. 빌드 CSS에 .prose 규칙이 실제로 생성되는지 grep으로 확인할 수 있다.

참고

  • 재현: Editor + view.someProp("handleTextInput", ...)로 실제 타이핑 시뮬레이션

Clone this wiki locally