노션에서 마크다운 복사 시 서식 깨짐 해결법
노션의 마크다운 복사·내보내기 시 발생하는 서식 깨짐 유형과 원인을 파악하고, 각 문제를 해결하는 방법을 단계별로 설명합니다.
Q.노션에서 마크다운으로 복사하면 서식이 깨지는 이유는 무엇인가요?
노션은 CommonMark 표준과 다른 자체 마크다운 문법을 사용합니다. 토글, Callout 박스, 인라인 수식 등 노션 전용 블록이 표준 마크다운에 없어 내보낼 때 HTML 태그나 깨진 서식으로 변환됩니다. 내보내기 전 해당 블록을 일반 텍스트나 인용구로 변환해두는 것이 가장 확실한 방법입니다.
노션에서 작성한 문서를 복사해 깃허브 README나 워드프레스 블로그에 붙여넣으면 토글이
핵심 답변
노션은 CommonMark 표준과 다른 자체 마크다운 문법을 사용합니다. 토글, Callout 박스, 인라인 수식 등 노션 전용 블록이 표준 마크다운에 없어 내보낼 때 HTML 태그나 깨진 서식으로 변환됩니다. 내보내기 전 해당 블록을 일반 텍스트나 인용구로 변환해두는 것이 가장 확실한 방법입니다.
노션 마크다운의 비표준 요소
| 노션 블록 | 내보내기 결과 | 표준 마크다운 대안 |
|---|---|---|
| 토글 | | 일반 섹션(###) |
| Callout 박스 | 깨진 이모지+텍스트 | 인용구(>) |
| 인라인 수식 | 일부 플랫폼 미지원 | LaTeX 코드블록 |
| 데이터베이스 | 복잡한 HTML 테이블 | 수동 마크다운 표 |
| 동기화 블록 | 내보내기 제외 | 개별 내보내기 필요 |
| 컬럼 레이아웃 | 무시됨 | 단일 열로 통합 |
해결 방법 1 - 내보내기 전 사전 변환
가장 확실한 방법은 내보내기 전에 노션에서 직접 수정하는 것이다.
- 토글 → 토글 내용을 펼쳐서 일반 헤딩(
###)으로 변환 - Callout → 인용구로 변환(블록 타입 변경:
/quote) - 컬럼 레이아웃 → 순서대로 단일 열 배치로 재구성
해결 방법 2 - 내보내기 설정 최적화
노션 내보내기 옵션(우측 상단 ··· → 내보내기):
- 형식: Markdown & CSV (HTML보다 마크다운 선택)
- 콘텐츠 포함: 하위 페이지, 파일&미디어 선택 여부
- 단일 페이지 vs 전체: 단일 페이지가 서식 손상 적음
해결 방법 3 - 내보내기 후 후처리
내보낸 마크다운 파일의 잔여 HTML 태그를 정규식으로 정리한다.
# 토글 태그 제거
찾기: <details>[sS]*?<summary>(.*?)</summary>
바꾸기: ### $1
# details 닫기 태그 제거
찾기: </details>
바꾸기: (빈 칸)
VS Code의 정규식 찾기·바꾸기(Ctrl+H, .* 활성화)로 적용한다.
해결 방법 4 - Pandoc 변환
bash
pandoc -f markdown -t commonmark input.md -o output.md
CommonMark 형식으로 재변환하면 비표준 요소가 정리된다.
실무 권장 워크플로우
- 노션에서 비표준 블록을 표준 블록으로 변환
- Markdown 형식으로 내보내기
- Pandoc으로 CommonMark 재변환
- 정규식으로 잔여 HTML 태그 제거
- 대상 플랫폼에서 렌더링 확인
실전 예제 - 노션 내보내기 전후 비교
노션에서 자주 쓰는 블록이 내보내기 후 어떻게 변환되는지 살펴본다.
토글 블록 내보내기 전/후
노션에서 작성한 토글 블록:
▶ 더 보기: 관련 자료
- 자료 A
- 자료 B
마크다운 내보내기 결과:
html
<details><summary>더 보기: 관련 자료</summary>
- 자료 A
- 자료 B
</details>
CommonMark 호환 형식으로 변환:
markdown
### 더 보기: 관련 자료
- 자료 A
- 자료 B
Callout 블록 내보내기 전/후
노션 Callout:
💡 핵심 포인트: 마크다운은 CommonMark 표준을 따르면 플랫폼 호환성이 높아집니다.
내보내기 결과(깨진 상태):
💡 핵심 포인트: 마크다운은 CommonMark 표준을 따르면 플랫폼 호환성이 높아집니다.
CommonMark 인용구로 변환:
markdown
> 💡 **핵심 포인트**: 마크다운은 CommonMark 표준을 따르면 플랫폼 호환성이 높아집니다.
자주 묻는 질문
Q. 노션에서 GitHub README로 복사할 때 표가 깨지는 이유는 무엇인가요?
A. 노션의 표(Table 블록)는 마크다운으로 내보낼 때 비표준 형식으로 변환되거나 HTML 테이블로 출력되는 경우가 있습니다. GitHub는 CommonMark 기반 마크다운을 사용하므로 표준 파이프 테이블(|열1|열2|) 형식만 지원합니다. 해결 방법은 노션 표를 CSV로 별도 내보내기 한 후 마크다운 테이블 변환 도구를 사용하거나, 표 내용을 수동으로 파이프 테이블 형식으로 재작성하는 것입니다.
Q. 노션 페이지를 워드프레스에 바로 붙여넣으면 어떻게 되나요?
A. 노션의 복사 기능은 HTML 형식과 일반 텍스트 형식 두 가지를 클립보드에 담습니다. 워드프레스 편집기에 붙여넣으면 HTML 형식이 우선 적용되는데, 노션 고유 클래스와 인라인 스타일이 포함되어 레이아웃이 어긋날 수 있습니다. 가장 깨끗하게 붙여넣는 방법은 Pandoc으로 CommonMark로 변환한 뒤, 워드프레스의 마크다운 블록 또는 Markdown 플러그인을 통해 삽입하는 것입니다.
마무리
이 글에서 정리한 기준을 실제 작업에 적용할 때는 [텍스터브 글자수 세기](/tools/char-counter/) 도구로 분량을 직접 확인하면서 진행하면 더 정확하게 맞출 수 있다.