Cloudwiki/에디터

정보:
Cloudwiki 의 문서 편집기에 대한 통합 안내 문서입니다. 위키 문법 자체에 대한 설명은 [[Cloudwiki/위키 문법 가이드]] 를 참고하세요.


# 개요

Cloudwiki 의 에디터는 [CodeMirror 6](https://codemirror.net/) 를 기반으로 하며, 위키 문법에 특화된 자동완성·툴바·미리보기·이미지 업로드·편집 충돌 해결 기능을 제공합니다. 문서 편집(`/edit/...`) 과 블로그 편집(`/blog/edit/...`) 두 모드에서 사용되며, 대부분의 기능이 공통입니다.

# 주요 기능

| 기능 | 설명 | 상세 문서 |
| --- | --- | --- |
|  툴바 | 마크다운/위키 문법을 클릭으로 삽입하는 상단 툴바와 모달 | [[Cloudwiki/에디터/툴바]] |
|  단축키 | 저장, 찾기/바꾸기, 텍스트 편집 단축키 | [[Cloudwiki/에디터/단축키]] |
|  자동완성 | 위키 문법 문자별 자동완성 | [[Cloudwiki/에디터/자동완성]] |
|  이미지 업로드 | 드래그앤드롭, 파일 선택, 클립보드, 기존 이미지 검색, 크롭/회전 | [[Cloudwiki/에디터/이미지 업로드]] |
|  편집 요약 / 카테고리 | 편집 요약 자동 prefix, 카테고리 태그 입력 | [[Cloudwiki/에디터/편집 요약]] |
|  편집 충돌 | 동시 편집 감지, 3-way merge, 로컬 초안 복구 | [[Cloudwiki/에디터/편집 충돌]] |

# 두 가지 편집 모드

## 문서 편집기 (`/edit/문서제목`)

위키 문서를 편집하는 기본 에디터입니다. 본 문서에서 안내하는 모든 기능을 사용할 수 있습니다.

- 카테고리 / 리다이렉트 / 관리자 전용 잠금 설정
- 섹션 단위 편집 (목차의 [편집] 버튼)
- 편집 요약 자동 작성
- 동시 편집 감지 및 3-way 충돌 해결
- 리비전 기반 버전 관리

## 블로그 편집기 (`/blog/edit`, `/blog/edit?id=...`)

블로그 포스트 작성용 에디터입니다. 위키 본문 편집 기능은 동일하지만 다음 기능이 비활성화 됩니다.

- ==카테고리 입력==
- ==리다이렉트 설정==
- ==관리자 전용 잠금==
- ==섹션 단위 편집==
- ==편집 충돌 해결 UI==



# 빠른 시작

1. **본문 작성** — 마크다운으로 자유롭게 입력합니다. 문법 안내는 [[Cloudwiki/위키 문법 가이드]] 참고.
2. **위키 링크 추가** — `[[` 를 입력하면 다른 문서를 검색하는 자동완성이 뜹니다.
3. **아이콘/색상 삽입** — `{` 를 입력하면 사용 가능한 모든 코드 템플릿(`{bi:`, `{bg:`, `{dday:` 등) 메뉴가 표시됩니다.
4. **이미지 업로드** — 툴바의  버튼을 누르거나, 본문 영역에 이미지 파일을 드래그하세요.
5. **저장** — `Ctrl+S` 또는 우측 하단의 **저장** 버튼.