Cloudwiki/기능/문서

참고 : 표의 병합된 셀은 빈칸으로 표시됩니다

# 문서

Cloudwiki의 모든 콘텐츠는 **문서** 단위로 관리됩니다. 각 문서는 고유한 제목을 가지며, 선택적으로 대체 제목을 붙여 표시 이름을 별도로 지정할 수 있습니다.

---

## 제목

제목은 문서의 **유일한 식별자**입니다. URL, 위키 링크, 틀, MCP 호출, 하위문서 경로 구성 등 **모든 "정확한 문서 호출"은 반드시 제목을 기준**으로 합니다.

### 금지 문자

제목에는 아래 특수문자를 ==**사용할 수 없습니다**==.

| 금지 문자 |  |
|---|---|
| `[` `]` | 위키 링크 `[[ ]]` 구문과 충돌 |
| `{` `}` | 틀 `{{ }}` 구문과 충돌 |
| `(` `)` | 링크 `[표시 텍스트](링크)`구문 충돌 |
| `#` | 목차 앵커와 충돌 |
| `%` | URL 인코딩 문자와 충돌 |
| `\|` | 위키 테이블 구문과 충돌 |
| `<` `>` | HTML 태그와 충돌 |
| `^` 및 제어 문자 | 기타 |

숫자, 공백, 하이픈(`-`), 언더스코어(`_`), 마침표(`.`), 쉼표(`,`), 콜론(`:`), 세미콜론(`;`), 슬래시(`/`), 물결(`~`) 등은 사용할 수 있습니다.


## 대체 제목

대체 제목은 **표시 전용** 별칭입니다. `심박수#0822`, `Leo/need` 처럼 제목에 넣기 어려운 특수문자가 포함된 이름을 그대로 표기하고 싶을 때 사용합니다.

### 특징

- 특수문자를 자유롭게 사용 가능합니다.
- 최대 100자입니다.
- 기본값은 빈칸이며, 설정하지 않으면 제목이 그대로 표시됩니다. 특수문자 사용이 필요 없는 경우, 대체 제목을 비워두는것을 권장합니다.
- 대체 제목이 설정되면 문서 제목, 브라우저 탭 제목에 대체 제목이 표시되고, 제목 아래 오른쪽에 실제 제목이 작은 회색 글씨로 표시됩니다.

### 주의 사항

> ==== 위키 링크 `[[ ]]`, 틀 `{{ }}`, MCP 도구, URL 등 **모든 문서 식별·호출 경로는 반드시 제목을 사용**합니다.
> 대체 제목사용이 불가능합니다.

#### 예시

제목 `심박수 0822`, 대체 제목 `심박수#0822` 으로 설정했을 때
올바른 링크 호출은`[[심박수 0822]]` 입니다. `[[심박수#0822]]`는 호출이 불가능합니다.


### 검색

검색 기능은 제목과 대체 제목 **모두** LIKE 매칭 대상에 포함합니다. 따라서 대체 제목으로 검색해도 문서를 발견할 수 있습니다.

### 중복 규칙

대체 제목은 다른 모든 문서의 제목 및 대체 제목과 중복될 수 없습니다. 마찬가지로 새 제목은 기존 어떤 문서의 대체 제목과도 같을 수 없습니다.

### 설정 방법

문서 편집기에서 상단 **"대체 제목"** 입력란에 원하는 이름을 입력하고 저장합니다. 


## 하위문서 구조 

제목에 슬래시(`/`)를 사용하면 문서를 구조화하고, 효율적인 탐색 및 관리에 도움이 됩니다.

| 제목 | 의미 |
|---|---|
| `Cloudwiki` | 최상위 문서 |
| `Cloudwiki/기능` | Cloudwiki 의 하위문서 |
| `Cloudwiki/기능/문서` | Cloudwiki/기능 의 하위문서 (현재 문서) |

### 특징

- 상위문서가 없어도 하위문서를 독립적으로 만들 수 있습니다.
- 위키 링크에서 슬래시 경로를 모두 포함해 사용합니다. `[[Cloudwiki/기능/문서]]`
- 하위 문서 카테고리 자동 관리 또는 일괄 적용, 문서 구조 탐색에 사용됩니다.

## 특수 문서: 네임스페이스

일부 제목은 **콜론(`:`)으로 구분된 네임스페이스 접두사**를 가집니다.

```
네임스페이스:문서제목
```

| 제목 | 의미 |
|---|---|
| `틀:Cloudwiki 문서 디렉토리` | 틀 네임스페이스 |
| `카테고리:Cloudwiki 기능` | 카테고리 네임스페이스 |
| `freq:LCD-X-left` | [[Cloudwiki/확장 기능/freq|freq 확장 기능]] 문서 네임스페이스 |