피드로 돌아가기
Dev.toFrontend
원문 읽기
Notion/Obsidian Export 데이터 정규화를 통한 Markdown 빌드 안정성 확보
How to Fix Messy Markdown from Notion or Obsidian
AI 요약
Context
Notion 및 Obsidian 내보내기 시 발생하는 불규칙한 Whitespace, 비정상적 Heading 계층, 유효하지 않은 HTML 태그로 인한 정적 사이트 생성기(SSG) 빌드 오류 발생. 원본 콘텐츠의 무결성과 별개로 문서 구조의 비정규화가 렌더링 단계의 레이아웃 붕괴를 초래하는 상황.
Technical Solution
- Heading 스타일 단일화를 통한 문서 계층 구조의 논리적 정규화
- 빈 불렛 포인트 및 불필요한 Blank Line 제거를 통한 Markdown Linter 노이즈 최소화
- 빈 href 및 내부 앵커 등 Dead Links 제거를 통한 스테이징 단계의 링크 무결성 확보
- 코드 펜스 내 Language Tag 강제 부여를 통한 렌더러별 구문 강조(Syntax Highlighting) 일관성 유지
- 정규화 프로세스 자동화를 통한 수동 편집 비용 제거 및 데이터 파이프라인 효율 증대
실천 포인트
- Heading 계층의 Top-level 스타일 통일 여부 확인 - 정적 사이트 생성기 임포트 전 빈 라인 및 불렛 포인트 스트리핑 수행 - 배포 전 단계에서 무효한 내부 링크 및 앵커 제거 스크립트 실행 - 모든 코드 블록에 명시적인 언어 식별자 태그 포함 여부 검증