1

Wiki 3 1 Stage 0 MDX Normalization

kyeongmin edited this page 2026-04-01 16:16:50 +09:00

Table of Contents

• 목적
• 입력
• 처리 내용
• 출력
• 검증 포인트
• 실패 시 처리

# Stage 0 입력 로드 및 MDX 정규화

목적

입력 콘텐츠를 후속 stage가 안정적으로 다룰 수 있는 표준 형태로 정리한다.

입력

• 원본 MDX 또는 문서 콘텐츠
• frontmatter가 있을 경우 그 메타데이터

처리 내용

• frontmatter를 분리한다.
• 본문을 정규화한다.
• 섹션 경계를 표준화한다.
• 불필요한 표기 흔들림을 줄인다.

출력

• 정규화된 MDX 텍스트
• 섹션 단위 구조 정보
• 메타데이터 요약

검증 포인트

• 원문 의미가 훼손되지 않았는가
• 섹션 경계가 안정적으로 유지되는가
• 후속 stage가 읽기 쉬운 형태인가

실패 시 처리

• 정규화 규칙을 조정한다.
• 섹션 분할 기준을 다시 잡는다.
• 원문 보존을 우선한다.