Confluence는 당신이 떠나기를 원하지 않습니다. Atlassian은 콘텐츠를 독점 XML 형식으로 저장하고, Markdown 내보내기를 제공하지 않으며, 대량 추출을 어렵게 만듭니다. Confluence에서 깨끗한 텍스트를 얻으려고 해본 적이 있다면 그 좌절감을 알 것입니다.

이 가이드는 Confluence 페이지를 Markdown으로 내보내는 모든 방법을 다룹니다 --- 단일 페이지부터 전체 스페이스까지.

Confluence를 Markdown으로 내보내는 이유?

팀들이 Confluence를 떠나는 이유는 여러 가지입니다:

새로운 도구로 마이그레이션 --- Markdown을 기대하는 Notion, GitBook, Docusaurus 또는 정적 사이트 생성기로 이동
지식 베이스 보관 --- Atlassian 라이선스가 만료되기 전에 팀 문서 보존
AI 지식 베이스 구축 --- Claude, ChatGPT 또는 내부 LLM에 깨끗한 문서 제공
중요 문서 백업 --- Atlassian 서버에 의존하지 않는 이식 가능한 사본 보유
벤더 종속성 탈출 --- 범용 형식으로 콘텐츠 소유

방법 1: Save (개별 페이지에 가장 빠름)

Save는 한 번의 클릭으로 어떤 Confluence 페이지든 깨끗한 Markdown으로 변환하는 Chrome 확장 프로그램입니다.

작동 방식:

Chrome에서 Confluence 페이지 열기
Save 확장 프로그램 아이콘 클릭
.md 파일이 즉시 다운로드

받게 되는 것:

제목 계층 구조가 있는 전체 페이지 텍스트
Markdown 테이블로 형식화된 표
언어 태그가 있는 코드 블록
인용 블록으로 변환된 정보 패널
펼치기/접기 섹션 (완전히 펼쳐짐)
깨끗한 메타데이터: 페이지 제목, 스페이스 이름, 최종 업데이트 날짜
내부 및 외부 링크 보존

제거되는 것:

Atlassian 매크로 및 독점 서식
탐색 크롬, 사이드바, 메뉴
WYSIWYG 편집기 아티팩트
인라인 스타일 및 CSS

최적: 개별 페이지 또는 소규모 배치 저장. 5-50개 페이지가 필요한 경우 이것이 가장 빠른 방법입니다.

출력 예시

일반적인 Confluence 런북에서:

# Deployment Runbook --- Production API

**Space:** Engineering
**Last updated:** March 12, 2026

---

## Pre-Deployment Checklist

- [ ] All CI checks passing on `main`
- [ ] Database migrations reviewed and approved
- [ ] Feature flags configured for gradual rollout
- [ ] Rollback plan documented

## Deployment Steps

### 1. Create Release Branch

\`\`\`bash
git checkout -b release/v2.4.0 main
git push origin release/v2.4.0
\`\`\`

### 2. Run Database Migrations

\`\`\`sql
ALTER TABLE users ADD COLUMN preferences JSONB DEFAULT '{}';
CREATE INDEX idx_users_preferences ON users USING GIN (preferences);
\`\`\`

방법 2: Confluence 내장 내보내기 (HTML, 그 다음 변환)

Confluence는 페이지를 HTML로 내보낼 수 있습니다. 그런 다음 Pandoc 같은 도구를 사용하여 HTML을 Markdown으로 변환할 수 있습니다.

단계:

페이지로 이동 → … 메뉴 → PDF/Word/HTML로 내보내기
HTML 내보내기 선택
Pandoc으로 변환: pandoc input.html -o output.md

이 방식의 문제점:

HTML 내보내기에 Atlassian의 CSS, 매크로, 인라인 스타일 포함
변환 중 표가 자주 깨짐
코드 블록이 언어 태그 잃음
이미지가 나중에 깨질 수 있는 Confluence URL 참조
중첩 페이지는 전체 스페이스 내보내기 필요

이 방법은 작동하지만 수동 정리가 필요한 지저분한 출력을 생성합니다.

방법 3: 스페이스 내보내기 + 대량 변환

전체 Confluence 스페이스 내보내기:

스페이스 설정 → 콘텐츠 도구 → 내보내기로 이동
HTML 형식 선택
ZIP 아카이브 다운로드
스크립트를 사용하여 HTML 파일을 Markdown으로 일괄 변환

문제점: Confluence 스페이스 내보내기는 깨진 상대 링크, 중복 탐색 요소, Atlassian 특정 마크업이 있는 깊이 중첩된 HTML을 생성합니다. 이것을 프로그래밍 방식으로 정리하는 것은 주말 프로젝트입니다.

방법 4: Confluence REST API

프로그래밍 방식 접근:

curl -u [email protected]:API_TOKEN \
  "https://your-domain.atlassian.net/wiki/rest/api/content/PAGE_ID?expand=body.storage" \
  | jq -r '.body.storage.value' > page.html

이것은 원시 저장 형식(XHTML과 유사)을 제공합니다. 다음이 필요합니다:

Atlassian 저장 형식 파싱
매크로, 임베드 및 특수 요소 처리
Markdown으로 변환
모든 페이지에 반복

최적: 마이그레이션 파이프라인을 구축하는 엔지니어링 팀. 대부분의 사용 사례에는 과도합니다.

어떤 방법을 사용해야 하나?

시나리오	최선의 방법
1-50 페이지 빠르게 저장	Save 확장 프로그램 --- 페이지당 한 번의 클릭
전체 스페이스 보관	스페이스 내보내기 + Pandoc --- 대량이지만 지저분함
마이그레이션 파이프라인 구축	REST API --- 프로그래밍 방식이지만 복잡함
주요 문서 빠른 백업	Save 확장 프로그램 --- 가장 깨끗한 출력
LLM에 문서 제공	Save 확장 프로그램 --- Markdown은 LLM 네이티브

대부분의 사람들에게 Save가 답입니다. 설정 없이 가장 깨끗한 Markdown을 생성하고, Confluence의 독점 서식을 자동으로 처리합니다.

Confluence 콘텐츠를 유용하게 만들기

페이지를 Markdown으로 내보낸 후 다음을 할 수 있습니다:

모든 것 검색 --- grep, VS Code 또는 Obsidian으로
Claude 또는 ChatGPT에 제공 --- 문서에 대한 즉각적인 답변
Git에서 버전 관리 --- 코드처럼 문서 변경 추적
어떤 도구로든 가져오기 --- Notion, Obsidian, GitBook, Docusaurus 또는 정적 사이트 생성기
영원히 보관 --- Markdown 파일은 일반 텍스트. 50년 후에도 읽을 수 있습니다

시작하기

Save 설치 후 지금 바로 Confluence 페이지에서 시험해보세요. 무료로 시작할 수 있으며 몇 초 안에 깨끗한 Markdown을 볼 수 있습니다.

Confluence를 탈출하는 것이 고통스러울 필요는 없습니다. Save는 한 번의 클릭으로 어떤 페이지든 깨끗한 Markdown으로 변환합니다.