노션 마크다운 → 워드프레스 변환기

노션 마크다운 → 워드프레스 변환기 사용법

노션에서 작성한 글을 워드프레스로 옮길 때 가장 큰 문제는 ‘노션 고유 블록’이 표준 마크다운으로 표현되지 않는다는 점입니다. 노션의 콜아웃(💡 박스), 토글(접고 펼치는 블록), 페이지 링크([[페이지 제목]]), 데이터베이스 인라인 뷰, 임베드 등은 노션 마크다운으로 내보내도 워드프레스가 인식하지 못하는 형식으로 남습니다. 본 도구는 이러한 노션 고유 요소를 워드프레스 구텐베르크 블록 마크업(, , )으로 자동 변환합니다.

구텐베르크 블록 마크업으로 변환하면 워드프레스 편집기에 그대로 붙여 넣었을 때 노션과 거의 동일한 시각적 구조로 표시됩니다. 클래식 에디터를 사용 중이라면 ‘클래식(HTML)’ 옵션을 선택해 <details> + <blockquote> 기반의 HTML로 변환할 수 있고, Jetpack 마크다운 플러그인을 쓴다면 ‘정제 마크다운’을 선택해 노션 고유 표기만 정리한 깨끗한 GFM을 받을 수 있습니다.

변환 매핑 표

콜아웃 > 💡 ... → 구텐베르크 그룹 블록(wp:group) + 배경색
토글 ▾ ... \t본문 → wp:details + <summary>
임베드(YouTube·Twitter URL) → wp:embed 블록
페이지 링크 [[페이지]] → 내부 검색 URL 링크(?s=) 또는 사용자 지정 베이스
표 → wp:table 블록 + <figure> 래퍼
체크박스 - [ ]/- [x] → wp:list + 이모지(☐/☑)
인라인 코드, 코드블록, 이미지, 헤딩(H1-H6) → 표준 마크다운 유지

워드프레스 붙여넣기 팁

변환 결과를 복사한 뒤 워드프레스 편집기에서 ‘코드 편집기 보기(Code Editor)’로 전환하고 그대로 붙여 넣으면 가장 안정적으로 블록이 인식됩니다. 시각적 편집기에 바로 붙여 넣으면 일부 블록 마커가 단순 텍스트로 처리될 수 있습니다.

자주 묻는 질문 (FAQ)

Q. 노션에서 마크다운은 어떻게 내보내나요?

A. 노션 페이지 우상단 메뉴(⋯) → 내보내기 → 형식: ‘마크다운 & CSV’ → 폴더의 .md 파일을 메모장으로 열어 전체 복사 후 본 도구에 붙여 넣으세요.

Q. 이미지 파일도 처리되나요?

A. 마크다운 내 이미지 링크(![alt](url))는 그대로 유지됩니다. 단, 노션 내부 이미지는 별도 업로드가 필요하므로 변환 전 워드프레스 미디어 라이브러리에 이미지를 먼저 업로드하고 URL을 교체하세요.

Q. 데이터베이스 뷰는 변환되나요?

A. 노션 데이터베이스 뷰는 마크다운으로 내보낼 때 단순 표(CSV)로만 출력됩니다. 본 도구는 이 표를 wp:table 블록으로 변환해 줍니다. 필터·정렬 같은 인터랙티브 기능은 변환되지 않으며, 워드프레스에서는 별도 테이블 플러그인이 필요합니다.

변환 결과 복사 공유