모든 가이드 보기

문서 변환

Confluence 페이지를 Markdown으로 옮기는 세 가지 경로

Confluence에서 복사한 제목과 목록은 잘 옮겨져도 표가 한 줄로 합쳐지거나 첨부 링크가 사내 주소로 남을 수 있습니다. 먼저 붙여넣고, 구조가 사라졌다면 Quick Send나 HTML 파일로 바꿔 시도하세요.

완료할 작업제목·목록·표·링크를 확인한 UTF-8 .md 파일
01

1. 먼저 필요한 본문만 복사합니다

페이지 전체가 아니라 제목부터 마지막 문단까지 필요한 영역만 선택합니다. 상단 탐색, 댓글, 관련 페이지 카드는 Markdown에 들어와도 다시 쓸 일이 거의 없습니다.

MD.SAVE 편집기에 붙여넣었을 때 제목이 #, 목록이 -, 표가 파이프 문자로 바뀌면 클립보드에 구조화된 HTML이 들어온 것입니다. 이 경우가 가장 빠르고 결과도 단순합니다.

  • 표가 행과 열로 보이는지 미리보기에서 확인
  • 문서의 첫 제목이 H1인지 문서 개요에서 확인
  • 사내 상대 링크와 첨부 파일 주소는 새 환경에서도 열리는지 확인
02

2. 일반 텍스트만 들어오면 Quick Send를 씁니다

일부 Confluence 화면은 복사할 때 서식을 제거합니다. 제목이 모두 평문으로 들어오거나 표가 탭으로 이어진 한 문장이 되면 같은 붙여넣기를 반복할 이유가 없습니다.

MD.SAVE Quick Send에서 선택 영역을 보내면 현재 화면의 제목, 목록, 링크와 표를 직접 읽어 Markdown으로 재구성합니다. 확장은 사용자가 실행한 현재 탭과 선택 영역에만 임시로 접근합니다.

03

3. 여러 페이지를 보관할 때는 HTML 내보내기를 비교합니다

페이지 수가 많거나 원본을 함께 보관해야 한다면 Confluence의 HTML 내보내기 파일을 MD.SAVE에서 여는 편이 낫습니다. MD.SAVE는 2MB 이하의 UTF-8 HTML을 브라우저에서 변환합니다.

매크로, 접힌 영역, 병합 셀, iframe은 Markdown에 일대일로 대응하지 않습니다. 이 요소는 변환 실패가 아니라 형식 차이이므로, 의미를 문장이나 단순 표로 다시 적는 편이 오래 갑니다.

04

4. 저장 전에 이 네 곳만 다시 봅니다

  • 병합 셀이 있던 표의 열 이름과 값이 어긋나지 않았는가
  • 이미지 설명이 파일명만 남지 않았는가
  • 로그인이 필요한 링크를 외부 공유 문서에 그대로 넣지 않았는가
  • 빈 링크, 건너뛴 제목 단계, 닫히지 않은 코드 블록이 없는가
권장 파일 이름프로젝트명-의사결정-2026-08.md제품명-운영절차-v2.md
05

개인정보와 한계

붙여넣기와 HTML 변환은 현재 브라우저에서 처리됩니다. 다만 링크나 이미지 주소 자체가 원래 Confluence 서버를 가리킬 수 있으므로, 외부 공유 전에는 주소에 조직명·공간 키·내부 경로가 남지 않았는지 직접 확인해야 합니다.