MarkdownCo

컨플루언스 마크다운 변환기

Markdown을 붙여넣거나 업로드하면 Data Center, Server, Jira에 바로 사용할 수 있는 컨플루언스 위키 마크다운을 얻을 수 있습니다. 제목, 표, 코드 블록, 링크는 각각 대응하는 위키 마크다운 문법으로 변환되며, LaTeX 수식은 변경 없이 그대로 유지됩니다.

위키 마크다운 출력언어 태그가 포함된 코드 매크로LaTeX 수식 보존
document.md
confluence.txt

컨플루언스 위키 마크다운

입력하는 동안 출력이 실시간으로 갱신됩니다. Convert & Download를 누르면 파일로 저장할 수 있습니다.

마크다운을 컨플루언스로 변환하는 방법

.md 파일에서 컨플루언스용 위키 마크다운까지 3단계면 충분합니다.

1

마크다운 추가하기

에디터에 마크다운을 붙여넣거나 .md 파일을 드래그해서 추가하세요.

2

위키 마크다운 확인하기

입력하는 동안 오른쪽 패널에 컨플루언스 위키 마크다운이 표시됩니다. 내보내기 전에 코드 매크로와 표를 확인하세요.

3

변환 후 다운로드

Convert & Download를 누르면 위키 마크다운을 .txt 파일로 저장하고 변환 기록에 남길 수 있습니다.

컨플루언스 위키 마크다운이 쓰이는 곳

컨플루언스 위키 마크다운은 컨플루언스 Data Center, Server, Jira가 기본으로 해석하는 텍스트 형식입니다. 마크다운으로 작성하고 내보낼 때 변환하면 소스 파일은 git에 그대로 두면서 팀은 컨플루언스에서 읽을 수 있습니다.

Confluence Data Center and Server pages
Insert > Markup을 통해 붙여넣는 컨플루언스 Data Center 및 Server 페이지
Jira descriptions and comments
동일한 위키 마크다운 문법을 쓰는 Jira 설명란과 댓글
Bulk migration into Confluence
README와 문서 저장소를 컨플루언스로 대량 마이그레이션할 때
Runbooks and technical notes
마크다운으로 작성한 런북과 기술 노트를 게시할 때

마크다운이 컨플루언스 위키 마크다운으로 변환되는 방식

모든 마크다운 요소는 대응하는 위키 마크다운 문법으로 변환되며, 코드와 수식이 많은 실제 기술 문서로 테스트되었습니다.

코드 블록은 코드 매크로로 변환됩니다

펜스로 감싼 코드 블록은 언어 태그를 유지한 채 {code:language=...} 매크로로 변환되어, 컨플루언스에서 구문 강조가 그대로 적용됩니다.

Code blocks become code macros

표와 링크는 깔끔하게 변환됩니다

GFM 표는 ||header|| 행과 |cell| 행으로 매핑되고, [text](url) 형식 링크는 [text|url]로 변환됩니다. 중첩된 목록은 들여쓰기 단계를 그대로 유지합니다.

Tables and links convert cleanly

LaTeX 수식은 변경 없이 그대로 유지됩니다

$$ 블록과 인라인 $...$ 수식을 감지해 그대로 보존합니다. 간격 조정 명령어, 행렬 줄바꿈, 이스케이프된 중괄호까지 그대로 남기 때문에 컨플루언스 쪽 수식 매크로에서 정상적으로 렌더링할 수 있습니다.

LaTeX math passes through untouched

제목, 인용문, 구분선이 1:1로 매핑됩니다

# 제목은 h1.부터 h6.까지로, 인용 블록은 {quote} 블록으로, 구분선은 ----로 변환됩니다. 문서 구조는 줄 단위로 그대로 보존됩니다.

Headings, quotes, and rules map 1:1

Markdown to Confluence 자주 묻는 질문

위키 마크다운 출력, 코드 매크로, 수식 처리, 컨플루언스 클라우드 호환성에 대해 안내합니다.

마크다운을 컨플루언스 위키 마크다운으로 변환하려면 어떻게 하나요?

에디터에 마크다운을 붙여넣거나 .md 파일을 업로드하세요. 입력하는 동안 출력 패널에 위키 마크다운 미리보기가 표시됩니다. 결과를 받으려면 Convert & Download를 누르세요. 마크업이 .txt 파일로 변환 기록에 저장됩니다. 이 작업에는 로그인이 필요하며 크레딧이 사용됩니다. 자세한 내용은 요금 페이지를 확인하세요.

이 도구는 어떤 형식으로 출력하나요?

컨플루언스 위키 마크다운입니다. 컨플루언스 Data Center, Server, 레거시 에디터가 해석하는 텍스트 문법으로(h1. 제목, *굵게*, {code} 매크로, ||table|| 행), Jira의 설명란과 댓글에서 쓰이는 것과 같은 마크업 체계입니다.

출력물이 컨플루언스 클라우드에서도 작동하나요?

부분적으로 작동합니다. 컨플루언스 클라우드의 새 에디터에서는 Insert > Markup 옵션이 사라져서 위키 마크다운을 붙여넣을 수 없습니다. 위키 마크다운(wiki markup)은 Data Center, Server, 클라우드의 레거시 에디터, Jira에서는 정상적으로 동작합니다. 클라우드 새 에디터를 사용 중이라면 마크다운을 그대로 붙여넣으세요. 붙여넣는 순간 대부분의 문법이 자동으로 변환됩니다.

코드 블록은 어떻게 변환되나요?

펜스로 감싼 코드 블록은 {code:language=...} 매크로로 변환됩니다. 시작 펜스 뒤에 붙는 언어 식별자(```python, ```js 등)는 매크로에 그대로 전달되어, 컨플루언스가 알맞은 구문 강조를 적용합니다. 언어 태그가 없는 블록은 {code:language=text}로 변환됩니다.

LaTeX 수식은 어떻게 처리되나요?

한 글자도 바뀌지 않고 그대로 통과합니다. 변환기는 변환 전에 $$ 블록과 인라인 $...$ 수식을 감지해 두었다가 변환 후 원래대로 복원하므로, \, 같은 간격 조정 명령어나 행렬 줄바꿈 \\이 깨지지 않습니다. 컨플루언스에는 수식을 렌더링하는 기능이 기본 내장되어 있지 않으므로, 출력물은 사용 중인 인스턴스의 LaTeX 매크로 앱과 함께 사용하세요.

마크다운 표도 지원하나요?

네. GitHub 스타일 마크다운 표는 컨플루언스 표 문법으로 변환되어, 헤더 행은 ||header|| 셀로, 본문 행은 |cell| 행으로 바뀝니다. 위키 마크다운 표는 열 정렬 문법을 지원하지 않으므로 해당 문법은 변환 과정에서 제거됩니다.