Repository navigation
ELOG 003 note prose typography missing
wcorn edited this page Jun 6, 2026
·
1 revision
| 항목 | 내용 |
|---|---|
| 분류 | 🔧 트러블슈팅 |
| 날짜 | 2026-06 |
| 영역 | FE (Tiptap / Tailwind Typography) |
| 관련 이슈/PR | #430, #437 |
| 상태 | 해결 |
인덱스로 돌아가기: Engineering Log
노트 본문에서 ## 제목, 목록, 인용 등이 — 새 페이지든 기존 페이지든, 한글이든 영어든 — 전부 일반 텍스트로만 보였다. 마크다운 단축 입력이 안 먹는 것처럼 보였다.
"마크다운 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>와 동일하게 렌더 → "텍스트로만 보임"
-
@tailwindcss/typography@0.5.19devDependency 추가 -
index.css에@plugin "@tailwindcss/typography";등록 (Tailwind v4 방식)
빌드 CSS 검증:
| 수정 전 | 수정 후 | |
|---|---|---|
grep -c '\.prose' dist/assets/*.css |
0 | prose heading 규칙 생성 (font-size:2.14286em 등) + --tw-prose-* 토큰 + prose-invert 다크 |
heading/목록/인용이 정상 스타일로 표시됨.
- 증상 ≠ 원인. "마크다운이 안 변환된다"는 증상이었지만 변환은 정상이었고, 보이지 않은 건 스타일 때문이었다. 코드를 고치기 전에 재현 테스트로 어느 단계가 실패하는지 먼저 격리한 것이 헛수고를 막았다.
- Tailwind v4에서
prose를 쓰면@plugin "@tailwindcss/typography"등록이 필수. 빌드 CSS에.prose규칙이 실제로 생성되는지grep으로 확인할 수 있다.
- 재현:
Editor+view.someProp("handleTextInput", ...)로 실제 타이핑 시뮬레이션