컨플루언스는 가장 널리 사용되는 팀 위키 중 하나이며, 많은 조직은 컨플루언스에 속하는 워드 문서 라이브러리를 가지고 있습니다. Confluences Markdown 지원에는 특이점이 있습니다. 이 안내서는 가장 신뢰할 수 있는 Word로 Confluence 작업 흐름.
Confluence는 Markdown를 지원합니까?
Confluence는 부분적으로 Markdown를 지원하지만, 구현에 의존합니다.
- Confluence 클라우드 Markdown 매크로를 지원하고 특정 맥락에서 Markdown를 렌더링할 수 있지만, 네이티브 에디터는 자체 형식입니다.
- Confluence 데이터 센터 / 서버 또한 Markdown 매크로를 가지고 있습니다.
- 아틀라스시아 로보 / 새 편집자 최신 버전은 Markdown 붙여넣기 지원이 개선되었습니다
모든 버전에서 가장 신뢰할 수 있는 방법은 Word을 Markdown로 변환하는 것입니다 WordToMD, 다음 Markdown 컨텐츠를 Confluences Markdown 수입 기능을 사용하여 붙입니다.
방법 1: Markdown를 Confluence 편집기를 통해 붙여넣기
단계
- Word 문서를 Word에서 변환 WordToMD 그리고 Copy Markdown을 클릭하세요.
- Confluence에서 페이지 편집기를 열
- 삽입 메뉴 (+ 아이콘) 에서 마크업 또는 다른 매크로 → 마크업을 선택
- Markdown을 언어로 선택
- Markdown 내용을 붙여넣기
- 삽입을 클릭
마크업/Markdown 매크로는 페이지 내의 리치 텍스트로 콘텐츠를 렌더링합니다. Confluence 블록으로 변환하지는 않지만 헤더, 테이블 및 목록을 올바르게 렌더링합니다.
방법 2: Word 파일 수입
Confluence 클라우드에는 Word 수입 기능이 있습니다.
- 새 Confluence 페이지를 생성
- ... 메뉴 → Word 문서를 가져오기를 클릭
- .docx 파일을 선택하세요
이것은 간단한 문서에 효과가 있지만 복잡한 형식을 잃는 경향이 있습니다. Markdown 경로는 더 많은 통제력을 제공합니다.
방법 3: HTML로 변환
일부 팀은 HTML를 중간 형식으로 선호합니다. 왜냐하면 Confluence의 편집기에서는 HTML 페이스트를 받아들일 수 있기 때문입니다.
- Word doc를 Markdown로 변환 WordToMD
- Markdown를 HTML로 온라인 도구 또는
markedlibrary - Confluence 소스 에디터로 전환 (Ctrl+Shift+D 또는 툴바에서)
- HTML를 붙여
이 방법은 더 복잡한 형식을 유지하지만 더 많은 단계입니다.
형식화 호환성
| 원소 | Markdown | Confluence 렌더링 |
|---|---|---|
| H1-H6 부문 | ✅ | ✅ 올바른 렌더링 |
| 뚱뚱한 글자 / 곡면 글자 | ✅ | ✅ 올바른 렌더링 |
| 표지판 목록 | ✅ | ✅ 올바른 렌더링 |
| 번호가 표시된 목록 | ✅ | ✅ 올바른 렌더링 |
| 표 | ✅ | ✅ Markdown 매크로 |
| 코드 블록 | ✅ | ✅ Markdown 매크로 |
| 하이퍼링크 | ✅ | ✅ 올바른 렌더링 |
| 이미지 | ️ 외부 URL만 | ️ 인라인 첨부 파일은 수동으로 업로드해야 합니다 |
처리 테이블
Word 테이블을 GFM 파이프 문법으로 변환 WordToMD. Confluence’s Markdown macro renders these correctly:
| Project | Owner | Status |
|---|---|---|
| Website redesign | Alice | In progress |
| API migration | Bob | Complete |더 복잡한 테이블 연산에 대해, 참조 Markdown 표: 완전한 안내.
Confluence에서 코드 블록
Confluence는 자체 코드 블록 매크로를 가지고 있으며, 문법 하이라이트와 라인 번호를 제공합니다. Markdown 컨텐츠를 가져온 후, 더 나은 가독성을 위해 Markdown 매크로에서 코드 블록을 네이티브 Confluence Code Block 매크로로 교체해야 합니다:
- 페이지 편집
- 코드 섹션을 찾으세요
- 코드 블록 매크로를 삽입
- 문법 하이라이트를 위한 언어를 설정
- 코드를 붙여주세요
참조: Markdown 코드 블록 가이드 표준 문법에 대한 것입니다.
아틀라시아 Confluence 및 ADF
Confluence 클라우드에서 네이티브로 사용 아틀라스 문서 형식 (ADF) 풍부한 컨텐츠를 위한 JSON 스키마. 이 위에 Markdown 매크로가 있습니다. 프로그램적 수입의 경우 Confluence REST API는 ADF를 직접 받아 들인다. 자동화된 파이프라인을 구축하는 경우 Word → Markdown → ADF를 사용 가능한 라이브러리를 사용하여 변환합니다.
대부분의 팀에서는 수동 작업이 더 간단하고 빠르게 진행됩니다.
문서 라이브러리 이동
만약 당신이 Word 문서들을 Confluence로 이동하고 있다면:
- 모든 파일을 변환 WordToMD (또는 Pandoc 대량에 대한 경우)
- Confluence 공간을 만들고 페이지 계층을 계획
- 섹션으로 페이지를 가져오며, 관련 문서를 모 페이지로 그룹화
- Confluence-특별한 특징을 입력 후 추가: 레이블, 페이지 제한, @mentions
FAQ
마크로 없이 Markdown를 Confluence에서 네이티브로 사용할 수 있나요?
새로운 편집기와 함께 컨플루언스 클라우드의 일부 구성에서, 당신은 마크다운 단축키를 입력 할 수 있으며, 그들은 자동으로 변환 (e.g., 입력) ## H2를 생성합니다. 그러나 변환된 문서를 붙이는 데에는 Markdown 매크로가 더 신뢰할 수 있습니다.
내 헤드 포맷은 수입 후 손실됩니다 모든 것이 본체 텍스트처럼 보입니다. 이것은 보통 Markdown 매크로가 활성화되지 않았다는 것을 의미합니다. Markdown는 표준 편집기에 일반 텍스트로 붙이지 않는 마크업/Markdown 매크로 블록 안에 있어야 합니다.
표는 원시 파이프 문자로 표시됩니다. 동일한 문제 내용은 Markdown 매크로 안에 있어야 하며, 표준 텍스트 편집기에 포함되지 않아야 합니다.
Word 문서를 Confluence 페이지로 동기화하는 자동화 방법이 있나요? 예 Confluences 외부 문서 기능, 스크롤 버전, 또는 Confluence REST API을 사용하는 사용자 정의 스크립트는 Markdown 파일을 페이지로 자동으로 동기화할 수 있습니다.
결론
가장 깨끗한 Word로 Confluence 워크플로우는: WordToMD, 그리고 Markdown 매크로를 통해 가져오죠. 복잡한 문서 또는 대량 마이그레이션의 경우 HTML 중간 접근 또는 REST API 자동화는 더 많은 제어 기능을 제공합니다. 어느 쪽이든, 변환 전에 Word의 헤딩 스타일을 적절하게 사용하면 페이지 계층이 그대로 유지되도록 보장합니다.