텍스트 편집
2026년 5월 9일
노션에서 마크다운 복사 시 서식 깨짐 해결법
노션의 마크다운 복사·내보내기 시 발생하는 서식 깨짐 유형과 원인을 파악하고, 각 문제를 해결하는 방법을 단계별로 설명합니다.
Q.노션에서 마크다운으로 복사하면 서식이 깨지는 이유는 무엇인가요?
노션은 CommonMark 표준과 다른 자체 마크다운 문법을 사용합니다. 토글, Callout 박스, 인라인 수식 등 노션 전용 블록이 표준 마크다운에 없어 내보낼 때 HTML 태그나 깨진 서식으로 변환됩니다. 내보내기 전 해당 블록을 일반 텍스트나 인용구로 변환해두는 것이 가장 확실한 방법입니다.
노션 마크다운노션 내보내기노션 서식 깨짐노션 복사
노션에서 작성한 문서를 복사해 깃허브 README나 워드프레스 블로그에 붙여넣으면 토글이
노션 마크다운의 비표준 요소
| 노션 블록 | 내보내기 결과 | 표준 마크다운 대안 |
|---|---|---|
| 토글 | | 일반 섹션(###) |
| 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 태그 제거
- 대상 플랫폼에서 렌더링 확인
---
이 글은 AI가 공개 자료를 기반으로 작성했습니다. 노션 기능은 업데이트에 따라 변경될 수 있습니다.*