Confluence는 기업 지식이 살아 숨쉬는 곳입니다 — 그리고 그 지식을 다시 꺼내오기가 거의 불가능한 곳이기도 합니다. Atlassian의 독점 저장 형식, 불편한 내보내기, WYSIWYG 편집기 때문에 깨끗한 콘텐츠를 추출하기가 고통스럽습니다. Confluence 페이지를 Markdown으로 저장하는 방법을 소개합니다.

Confluence를 Markdown으로 저장해야 하는 이유

Confluence에서 콘텐츠를 가져오기는 악명 높을 정도로 어렵습니다:

독점 형식 — Confluence는 자체 XML 기반 형식으로 콘텐츠를 저장
HTML 내보내기가 지저분함 — Atlassian 매크로, 스타일, 마크업으로 가득 참
기본 Markdown 내보내기 없음 — 내보내기 메뉴에 해당 옵션 없음
대량 내보내기가 혼란스러움 — 스페이스 내보내기는 깨진 링크가 있는 중첩 HTML 생성
벤더 종속 — Confluence에서 마이그레이션하는 것 자체가 하나의 프로젝트

Save가 Confluence에서 캡처하는 것

페이지 콘텐츠

제목 계층 구조가 있는 전체 페이지 텍스트
표 (Markdown 표로 올바르게 형식화)
언어 태그가 있는 코드 블록
정보 패널과 메모 (블록 인용으로 변환)
펼치기/접기 섹션 (펼친 콘텐츠)
불릿 및 번호 목록
내부 및 외부 링크

출력 예시

# 배포 런북 — 프로덕션 API

**스페이스:** Engineering
**최종 업데이트:** 2026년 3월 12일

---

## 배포 전 체크리스트

- [ ] main의 모든 CI 검사 통과
- [ ] 데이터베이스 마이그레이션 검토 및 승인
- [ ] 점진적 롤아웃을 위한 기능 플래그 구성
- [ ] 대기 중인 엔지니어 확인 및 준비
- [ ] 롤백 계획 문서화

## 배포 단계

### 1. 릴리스 브랜치 생성

\`\`\`bash
git checkout main && git pull
git checkout -b release/v2.4.1
git push -u origin release/v2.4.1
\`\`\`

사용 사례

Confluence에서 마이그레이션

페이지를 하나씩 깨끗한 Markdown으로 저장
새 지식 베이스를 점진적으로 구축
Obsidian, Notion, GitBook 또는 docs-as-code 시스템으로 마이그레이션
값비싼 마이그레이션 도구 불필요

개인 지식 추출

업무와 가장 관련된 페이지 저장
휴대 가능한 참고 라이브러리 구축
회사를 떠난 후에도 문서에 접근 유지
중요한 런북의 오프라인 복사본 생성

AI 기반 검색

AI 처리를 위해 Confluence 페이지를 Markdown으로 저장
더 나은 검색을 위해 내부 문서를 AI 도구에 제공
RAG(검색 증강 생성)를 위한 Markdown 코퍼스 구축
회사 지식 베이스에서 AI 기반 답변 얻기

최선의 결과를 위한 팁

페이지 보기에서 저장 — 편집기나 스페이스 개요가 아닌 페이지 보기에서
모든 섹션 펼치기 — 저장 전에 모든 펼치기/접기 매크로를 클릭하여 펼치기
첨부 파일 — Save는 텍스트 콘텐츠를 캡처하며, 필요한 경우 첨부 파일은 별도로 다운로드
매크로 — Confluence 매크로(Jira 링크, 차트)는 일반 텍스트나 링크로 변환
권한 — Save는 볼 수 있는 권한이 있는 페이지만 캡처 가능

시작하기

Chrome Web Store에서 Save 설치 — Confluence 콘텐츠를 자유롭게 하세요.

질문이 있으신가요? [email protected]로 연락하세요