Cloudwiki/위키 문법 가이드

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

Cloudwiki에서 지원하는 기본 마크다운 문법과 확장 문법(위키 고유 문법)에 대한 안내입니다.
Cloudwiki 문법은 기존 일반 마크다운 문법과 호환되며, 일반 마크다운 문법으로 작성된 문서를 그대로 사용할 수 있습니다.


---

# 기본 마크다운 문법

## 텍스트 꾸미기

**굵게**
```
**굵게**
```

*기울임*
```
*기울임* 혹은 _기울임_
```

***굵게 + 기울임***
```
***굵게 + 기울임***
```

~~취소선~~
```
~~취소선~~
```

==형광펜 강조==
```
{bg:yellow}==형광펜 강조==
```
>  `==텍스트==` 는 그 자체로는 강조 효과가 없는 **형식 지정 캐리어**입니다. 앞에 `{bg:색}`(배경/형광펜)·`{color:색}`(글자색)·`{fs:크기}`(글자 크기)·`{palette:이름}` 토큰을 붙여 사용합니다. 자세한 내용은 아래 *컬러 코드* · *글자 크기* 절을 참고하세요.

__밑줄__
```
__밑줄__
```


> 여러 스타일을 조합할 수 있습니다. 예: **굵게 _기울임_**, ~~***굵고 기울인 취소선***~~

---

## 제목 (Headings)

제목은 `#` 기호의 개수로 단계를 구분합니다. `#`부터 `######`까지 6단계를 지원합니다.

```
# 제목 1단계
## 제목 2단계
### 제목 3단계
#### 제목 4단계
##### 제목 5단계
###### 제목 6단계
```

> `#` 뒤에 반드시 공백을 한 칸 넣어야 제목으로 인식됩니다.

### (확장) 제목으로 문단 접기

제목 **맨 끝**에 `{collapse}` 를 붙이면, 그 제목이 여는 **문단(섹션) 전체를 기본적으로 접힌 상태**로 표시합니다. 하위 제목까지 하나의 섹션으로 함께 접히며, 제목을 클릭하면 펼쳐집니다.

```
## 자세한 설명 {collapse}
이 문단은 처음에는 접혀 있습니다. 제목을 클릭하면 펼쳐집니다.

### 하위 제목도 함께 접힙니다
하위 내용까지 하나의 섹션으로 접힙니다.
```

- `{collapse}` 토큰 자체는 화면 제목·목차 카드·상세 목차 버튼·검색·AI 읽기 어디에도 노출되지 않습니다. 제목 텍스트의 일부로 인식되지 않으므로 위키 링크·섹션 참조에도 영향을 주지 않습니다.
- 제목 **맨 끝**에 있을 때만 동작합니다. (`## 개요 {collapse}` ✅ / `## {collapse} 개요` ❌)
- 제목 클릭으로 접고 펼치는 기능은 이 문법 없이도 항상 제공됩니다. `{collapse}` 는 문서를 열었을 때의 **초기 상태**를 "접힘" 으로 지정하는 역할입니다.
- 특정 내용 블록만 접으려면 아래 **펼치기/접기**(`[+ ]...[-]`) 문법을 사용하세요.

---

## 목록 (List)

### 순서 없는 목록
`-`, `*`, `+` 중 하나를 사용합니다. 들여쓰기(스페이스 2칸 또는 탭)로 하위 항목을 만들 수 있습니다.

- 항목 1
- 항목 2
  - 하위 항목 2-1
  - 하위 항목 2-2
    - 하위 항목 2-2-1

```
- 항목 1
- 항목 2
  - 하위 항목 2-1
  - 하위 항목 2-2
    - 하위 항목 2-2-1
```

### 순서 있는 목록
숫자와 마침표(`.`)를 사용합니다. 실제 입력한 숫자와 관계없이 순서대로 자동 번호가 매겨집니다.

1. 첫 번째
2. 두 번째
3. 세 번째
   1. 하위 항목

```
1. 첫 번째
2. 두 번째
3. 세 번째
   1. 하위 항목
```

### 체크리스트
- [ ] 미완료 항목
- [~] 진행 중 항목
- [x] 완료 항목

```
- [ ] 미완료 항목
- [~] 진행 중 항목
- [x] 완료 항목
```

>  진행 중 표시는 `- [~]` 와 `- [/]` 두 가지를 모두 지원하며, 동일하게 표시됩니다. 순서 있는 목록(`1. [~]`)에서도 사용할 수 있습니다.

---

## 링크

기본적으로 링크 및 이메일은 별도 문법 없이 붙여넣을 수 있습니다.

링크의 표시 텍스트를 설정할 수 있습니다.

[일반 링크](https://vialinks.xyz)
```
[일반 링크](https://vialinks.xyz)
```



URL을 그대로 링크로 표시하려면 꺾쇠괄호로 감쌉니다.

<https://vialinks.xyz>
```
<https://vialinks.xyz>
```


## 이미지

![Cloudwiki-로고.jpg](https://wiki.vialinks.xyz/media/images/Cloudwiki-로고.jpg)

```
![Cloudwiki-로고.jpg](https://wiki.vialinks.xyz/media/images/Cloudwiki-로고.jpg)
```
이미지의 경우, 문서 편집기의 이미지 업로드 기능 사용 시 자동으로 작성됩니다.

### (확장) 이미지 사이즈 지정

이미지 링크 뒤에 `{size:옵션}`을 붙여 이미지 사이즈를 조절할 수 있습니다.
지원되는 사이즈 옵션: `icon`, `small`, `medium`, `full(기본값)`
`icon` 설정 사용 시 이미지를 그대로 텍스트 줄 안에서 사용할 수 있습니다. 

[+ 사이즈별 이미지 보기]
![Cloudwiki-로고.jpg](https://wiki.vialinks.xyz/media/images/Cloudwiki-로고.jpg)
![Cloudwiki-로고.jpg](https://wiki.vialinks.xyz/media/images/Cloudwiki-로고.jpg)
![Cloudwiki-로고.jpg](https://wiki.vialinks.xyz/media/images/Cloudwiki-로고.jpg)
![Cloudwiki-로고.jpg](https://wiki.vialinks.xyz/media/images/Cloudwiki-로고.jpg)
[-]


```
![Cloudwiki-로고.jpg](https://wiki.vialinks.xyz/media/images/Cloudwiki-로고.jpg){size:icon}
![Cloudwiki-로고.jpg](https://wiki.vialinks.xyz/media/images/Cloudwiki-로고.jpg){size:small}
![Cloudwiki-로고.jpg](https://wiki.vialinks.xyz/media/images/Cloudwiki-로고.jpg){size:medium}
![Cloudwiki-로고.jpg](https://wiki.vialinks.xyz/media/images/Cloudwiki-로고.jpg){size:full}
```
문서 편집기에서 이미지를 첨부할 때 나타나는 사이즈 지정 옵션, 또는 이미지 문법에 커서를 가져다 놓을 때 나타나는 팝업을 통해 쉽게 옵션을 적용할 수 있습니다.

### (확장) 이미지 정렬·캡션

`{size:}` 와 같은 자리에 `{align:}`(정렬)·`{caption:}`(캡션) 토큰을 붙일 수 있습니다. 순서는 자유이며 함께 사용할 수 있습니다.

- `{align:left|center|right}` — 이미지를 왼쪽/가운데/오른쪽에 배치합니다.
- `{caption:텍스트}` — 이미지 아래에 회색 캡션을 표시합니다.

![Cloudwiki-로고.jpg](https://wiki.vialinks.xyz/media/images/Cloudwiki-로고.jpg)

```
![Cloudwiki-로고.jpg](https://wiki.vialinks.xyz/media/images/Cloudwiki-로고.jpg){size:small}{align:center}{caption:그림 1 — 가운데 정렬 + 캡션}
```

이미지가 한 문단에 단독으로 있을 때만 적용됩니다(텍스트와 섞인 인라인 이미지에서는 무시). 토큰은 닫는 괄호 `)` 바로 뒤에 공백 없이 붙여 작성하세요.

---

## 표

Cloudwiki 문법은 기본 마크다운 표 문법과 호환되며, 셀 병합, 색상 지정을 추가로 지원합니다.

### 기본 표

| 열 1 | 열 2 | 열 3 |
| --- | --- | --- |
| 내용 A | 내용 B | 내용 C |

```
| 열 1 | 열 2 | 열 3 |
| --- | --- | --- |
| 내용 A | 내용 B | 내용 C |
```


### 열 정렬

콜론(`:`)의 위치로 열의 정렬 방식을 지정할 수 있습니다.

| 왼쪽 정렬 | 가운데 정렬 | 오른쪽 정렬 |
| :--- | :---: | ---: |
| 내용 | 내용 | 내용 |

```
| 왼쪽 정렬 | 가운데 정렬 | 오른쪽 정렬 |
| :--- | :---: | ---: |
| 내용 | 내용 | 내용 |
```

### (확장) 셀 병합
셀의 좌우, 상하 병합을 지원합니다.
`{<}` `{>}` 문자를 통해 좌우 셀과 병합, `{^}` 문자를 통해 위 셀과 병합할 수 있습니다.
색상 문법은 병합 문법이 아닌 일반 내용 칸에 작성해야 합니다.

| 세로 병합 |  | 가로 병합 | 내용 |
| --- | --- | --- | --- |
|  | 내용 |  | 세로 병합 |
| 내용| 내용 | 내용 |  |

```
| 세로 병합 | {>} | 가로 병합 | 내용 |
| --- | --- | --- | --- |
| {^} | 내용 | {<} | 세로 병합 |
| 내용| 내용 | 내용 | {^} |
```

### (확장) 셀 가운데 병합

셀 병합 시 가운데로 모으고 싶은 경우, 병합할 가운데 셀에 `{><}`를 입력합니다.

| 내용 |  | 내용 |
| --- | --- | --- |
| 내용 | 내용 | 내용 |



```
| 내용 | {><} | 내용 |
| --- | --- | --- |
| 내용 | 내용 | 내용 |
```

### (확장) 셀 안 줄바꿈

표 셀 안에 `{br}` 토큰을 넣으면 셀 내부에서 줄바꿈이 적용됩니다. 표준 마크다운은 표 셀이 단일 라인이어야 하므로 직접 줄바꿈을 넣을 수 없지만, `{br}` 은 인라인 토큰이라 셀 안에서 자유롭게 사용할 수 있습니다.

| 항목 | 설명 |
| --- | --- |
| 첫 줄
두 번째 줄 | 한 셀에 여러 줄을 담을 수 있습니다. |
| 단일 줄 | 일반 텍스트는 그대로 동작합니다. |

```
| 항목 | 설명 |
| --- | --- |
| 첫 줄{br}두 번째 줄 | 한 셀에 여러 줄을 담을 수 있습니다. |
| 단일 줄 | 일반 텍스트는 그대로 동작합니다. |
```

>  위키 에디터에서는 표 셀 안에 커서를 두고 Shift+Enter 단축키로 `{br}` 토큰을 빠르게 삽입할 수 있습니다. `{br}` 의 일반적인 동작은 [[Cloudwiki/위키 문법 가이드/컴포넌트]] 의 *줄바꿈* 절을 참고하세요.

### (확장) 표 옵션 토큰

표 헤더 행 **바로 윗줄**에 단독 토큰 라인을 두면 표 전체에 옵션을 적용할 수 있습니다. 여러 토큰을 한 줄에 이어 쓸 수 있으며, 표 자체는 표준 마크다운 문법을 그대로 유지합니다.

| 토큰 | 값 | 효과 |
| --- | --- | --- |
| `{table:left}` `{table:center}` `{table:right}` | 선택 | 표 전체 정렬 |
| `{w:70%}` | `50%` ~ `100%` (10% 단위) | 표 전체 너비 |
| `{caption:제목}` | 텍스트 | 표 상단에 캡션(표 제목) 표시 |
| `{sticky-header}` | 켜기 | 긴 표 스크롤 시 헤더 행 고정 (표가 화면 높이의 70% 를 넘으면 내부 스크롤) |
| `{sortable}` | 켜기 | 헤더 클릭으로 행 정렬 (열람 화면 전용, 문서 데이터 불변) |
| `{row-header}` | 켜기 | 첫 열을 세로 헤더로 — 인포박스형 2열 표의 표준화 |


| 분기 | 매출 | 성장률 |
| --- | --- | --- |
| 1Q | 120 | +5% |
| 2Q | 90 | +11% |

```
{table:center}{w:70%}{caption:분기별 실적 요약}{sortable}
| 분기 | 매출 | 성장률 |
| --- | --- | --- |
| 1Q | 120 | +5% |
| 2Q | 90 | +11% |
```

유의 사항:

- 옵션 라인은 인용구·리스트 안이 아닌 **최상위 표**에서만 동작합니다.
- 옵션 라인에 알 수 없는 토큰이 섞이면 옵션이 아닌 일반 텍스트로 그대로 표시됩니다 (오타 확인용).
- `{sortable}` 은 숫자·퍼센트·콤마 표기(`1,200`, `+5%`)를 숫자로 인식해 정렬하며, 병합 셀이 있는 표에서는 자동으로 비활성화됩니다.
- `{sticky-header}` 와 `{sortable}` 은 헤더 행이 있는 표에서만 의미가 있습니다.

### (확장) 열 너비 지정

구분 행의 셀 뒤에 `{w:NN%}` 토큰을 붙이면 해당 열의 너비를 지정할 수 있습니다. 정렬 콜론과 함께 쓸 수 있고, 필요한 열에만 지정하면 됩니다.

| 항목 | 설명 |
| :---  | --- |
| 이름 | 첫 열은 30% 너비로 고정됩니다. |
| 비고 | 나머지 열이 남은 폭을 차지합니다. |

```
| 항목 | 설명 |
| :--- {w:30%} | --- |
| 이름 | 첫 열은 30% 너비로 고정됩니다. |
| 비고 | 나머지 열이 남은 폭을 차지합니다. |
```


---

## 수평선 

섹션을 구분할 때 사용합니다. `-`, `*`, `_` 중 하나를 3개 이상 연속으로 입력합니다.

---

```
---
***
___
```

## 인용구 및 코드 블록

> 인용문 예시입니다.
>> 중첩 인용문입니다.
```
> 인용문 예시입니다.
>> 중첩 인용문입니다.
```

`인라인 코드`
```
`인라인 코드`
```

```javascript
// 여러 줄 코드 블록
console.log("Test");
```
- 코드 블록을 작성하려면 백틱(`) 3개를 연달아 씁니다.
- 여러 줄 코드 블록을 시작하는 백틱 뒤에 프로그래밍 언어명을 지정하면, 해당 언어 문법에 맞는 하이라이트 처리가 작동합니다.
- 코드 블록 내부에 들어간 모든 내용은 위키 문법으로 작동하지 않습니다.


---

# 위키 확장 문법

## 위키 링크(내부 링크)

위키 내의 다른 문서로 이동할 수 있는 링크를 편리하게 생성합니다.
`|` 파이프 기호를 이용해 링크와 표시 텍스트를 변경하거나, `#목차번호` 기호를 이용해 문서의 특정 문단을 지정할 수 있습니다. 

[[문서제목]]
[[문서제목|표시텍스트]]
```
[[문서제목]]
[[문서제목|표시텍스트]]
```

[[문서제목#목차번호]] 형식으로 작성하면, 해당 링크를 클릭시 문서의 특정 목차로 이동됩니다.
`[[문서제목#1.1|표시 텍스트]]` 형식으로 표시 텍스트 문법과 함께 사용 가능합니다.


---

## 틀 (Transclusion)

다른 문서(틀)의 내용을 현재 문서에 포함시킬 때 사용합니다.
자세한 내용은 [[Cloudwiki/기능/틀]] 문서를 참고하세요.

---

테스트 틀입니다

```
틀 내부 코드블럭 테스트
```

테스트용 틀 끝

---




```
{{테스트}}
```

---

### 틀 파라미터

틀 문서 본문에 `{{{파라미터이름}}}` 을 입력하면, 해당 틀을 불러오는 문서별로 해당 부분에 다른 내용을 표시할 수 있습니다.
파라미터 내용에는 등호(=), 파이프 기호(|) 사용이 불가능하나, 소괄호　내부 문법의 파이프 기호 및 등호는 사용 가능합니다.

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


| 프로필 |  |
| --- | --- |
| 이름 | 하츠네미쿠 |
| 나이 | 16 |
| 성별 | 여 |


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


| 프로필 |  |
| --- | --- |
| 이름 | 카사네테토 |
| 나이 | 31 |
| 성별 | 여 |



```
{{틀:파라미터테스트|이름=하츠네미쿠|나이=16|성별=여}}
{{틀:파라미터테스트|이름=카사네테토|나이=31|성별=여}}
```

### 틀 조건문

틀 파라미터 값에 따라 출력 내용을 다르게 만들고 싶을 때 조건문을 사용할 수 있습니다. 주로 틀 본문에서 `{{{파라미터}}}` 값에 따라 분기할 때 사용합니다. 자세한 내용은 [[Cloudwiki/기능/틀]] 문서를 참고하세요.

**조건 분기** — `{{#if: 조건 | 참일때 | 거짓일때}}`
조건 텍스트가 (공백 제거 후) 비어있지 않으면 *참일때*, 비어있으면 *거짓일때* 를 출력합니다. *거짓일때* 는 생략 가능합니다.
```
{{#if: {{{별명|}}} | (별명: {{{별명}}}) }}
```

**값 비교** — `{{#ifeq: A | B | 같을때 | 다를때}}`
A 와 B 가 같으면 *같을때*, 다르면 *다를때* 를 출력합니다. 양쪽이 모두 숫자면 수치로(`1` 과 `1.0` 은 같음), 아니면 문자열로 비교합니다.
```
{{#ifeq: {{{성별|}}} | 여 | 그녀 | 그 }}
```

**다중 분기** — `{{#switch: 값 | 키1=결과1 | 키2=결과2 | #default=기본값}}`
*값* 과 일치하는 첫 케이스의 결과를 출력합니다. 일치하는 케이스가 없으면 `#default` 의 값을, 그것도 없으면 아무것도 출력하지 않습니다. 빈 문자열 케이스는 키 없이 `=결과` 로 적습니다.
```
{{#switch: {{{등급|}}}
| S = 🥇 최상위
| A = 🥈 상위
| #default = 일반
}}
```

>  조건·비교 값은 그 시점의 *문자열* 로 평가됩니다. 조건 안에서 다른 틀(`{{다른틀}}`)의 *렌더 결과* 로 분기할 수는 없으며, 표준적으로는 `{{{파라미터}}}` 값을 기준으로 분기합니다.

---

## 아이콘 삽입

CloudWiki는 부트스트랩 아이콘(Bootstrap Icons)과 MDI(Material Design Icons)를 지원합니다.

### 기본 문법


```
{bi:card-text}
```


```
{mdi:dots-vertical}
```


- 아이콘 목록은 아래 링크에서 확인할 수 있습니다.
>  [Bootstrap Icons](https://icons.getbootstrap.kr)
>  [Material Design Icons](https://pictogrammers.com/library/mdi)

** MDI에 포함된 기업 로고들이 다수 제거될 예정입니다. 기업 로고 삽입은 부트스트랩 아이콘 또는 이미지 삽입의 `{size:icon}` 파라미터 이용을 권장합니다.**

---

### 아이콘 자동완성

문서 편집기에서 `{mdi:`, `{bi:`를 입력하면 사용 가능한 아이콘 목록을 보여주는 메뉴가 표시되며, 클릭 또는 키보드 방향키 + 엔터로 자동완성이 가능합니다.


---

## 각주

문서 내에 부연 설명을 추가할 때 사용합니다.


부연 설명을 추가할 텍스트[* 여기에 각주 내용이 들어갑니다. **기본 마크다운 문법** 사용이 가능합니다.]

```
부연 설명을 추가할 텍스트[* 여기에 각주 내용이 들어갑니다. **기본 마크다운 문법** 사용이 가능합니다.]
```



---

## 펼치기/접기

문서 내에 내용을 숨겨두고 클릭하여 펼칠 수 있는 블록을 생성합니다.
제목에 지정한 `{bg:색상}`, `{color:색상}`, `{palette:이름}` 옵션으로 배경과 글씨 색상을 꾸밀 수 있습니다.

[+ 상세 내용 보기 (클릭)]
여기에 숨겨진 내용이 들어갑니다.
**마크다운** 문법도 이 안에서 정상 동작합니다.
[-]
```
[+ 상세 내용 보기 (클릭)]
여기에 숨겨진 내용이 들어갑니다.
**마크다운** 문법도 이 안에서 정상 동작합니다.
[-]
```

[+   커스텀 색상]
배경색과 글자색이 지정된 상태입니다.
[-]

```
[+ {bg:#f8f9fa} {color:blue} 커스텀 색상]
배경색과 글자색이 지정된 상태입니다.
[-]
```



## 컬러 코드

Cloudwiki는 인라인 텍스트, 표 셀, 펼치기/접기 제목, 컴포넌트 등에서 배경색과 글자색을 지정할 수 있는 확장 문법을 제공합니다.
색상 값은 `#ff0000`, `red` 모두 사용 가능합니다.

### 배경 및 글씨 색상

배경색은 `{bg:색상}`, 글자색은 `{color:색상}` 문법으로 지정합니다.

### 인라인 텍스트

일반 텍스트의 글씨 색을 변경하려면

==빨간색==
==파란배경흰글씨==
```
{color:#FF0000}==빨간색==
{bg:#0000FF}{color:#FFFFFF}==파란배경흰글씨==
```
형식으로 작성합니다.

>  `==...==` 는 앞에 붙인 `{bg:}`·`{color:}`·`{fs:}`·`{palette:}` 토큰의 적용 범위를 지정하는 **형식 캐리어**입니다. 토큰 없이 `==텍스트==` 만 쓰면 아무 효과도 적용되지 않습니다. 배경(형광펜) 효과는 `{bg:색}` 으로 지정하세요.


### 표

| 기본 셀 |  빨간 배경 |   검정 배경 흰 글씨 |
| --- | --- | --- |
| 내용 |  노란 배경 |  파란 글씨 |

```
| 기본 셀 | {bg:#ff0000} 빨간 배경 | {bg:#000000} {color:#FFFFFF} 검정 배경 흰 글씨 |
| --- | --- | --- |
| 내용 | {bg: yellow} 노란 배경 | {color: blue} 파란 글씨 |
```

>  배경과 글씨 색상을 모두 설정하는 것을 권장합니다. 둘 중 하나만 설정하는 경우, 다크 모드에서 가독성 문제가 생길 가능성이 높습니다.
## 컬러 팔레트

자주 쓰는 배경/글씨 조합을 미리 정의해두고 한 번에 적용하는 문법입니다.
`{palette:이름}` 는 해당 팔레트의 `{bg:...}{color:...}` 와 동일하게 동작합니다.`{bg:}`/`{color:}` 가 동작하는 모든 위치 에서 그대로 사용할 수 있습니다.

#### 기본 프리셋

별도 설정 없이 바로 쓸 수 있는 용도별 프리셋입니다. 부트스트랩 색상 체계를 따르며 다크 모드에도 자동으로 대응합니다.

| 이름 | 용도 |
| --- | --- |
| `primary` | 주요 강조 |
| `secondary` | 보조 |
| `success` | 성공 / 완료 |
| `info` | 정보 |
| `warning` | 경고 |
| `danger` | 위험 / 오류 |
| `muted` | 비활성 / 부가 |

|  primary |  success |  warning |  danger |
| --- | --- | --- | --- |
|  secondary |  info |  muted | 기본 셀 |

```
| {palette:primary} primary | {palette:success} success | {palette:warning} warning | {palette:danger} danger |
| --- | --- | --- | --- |
| {palette:secondary} secondary | {palette:info} info | {palette:muted} muted | 기본 셀 |
```

#### 커스텀 프리셋

사이트 관리자가 자주 쓰는 색 조합을 팔레트로 등록해두면 기본 프리셋과 동일한 방식으로 사용할 수 있습니다.

설정 방법은[[Cloudwiki/설정/컬러 팔레트]] 를 참고하세요.

#### 덮어쓰기

팔레트 뒤에 `{bg:...}` 또는 `{color:...}` 를 연달아 쓰면, 뒤에 오는 값이 팔레트의 해당 속성을 덮어씁니다.

```
{palette:cloudflare}{color:#ffffff}  → 배경은 팔레트, 글씨색만 흰색으로 강제
```

정의되지 않은 이름을 참조하면 화면에 표시될 때 토큰이 조용히 무시되며, 에디터에서는 자동완성 목록에 나타나지 않습니다.

## 글자 크기

`{fs:크기}` 토큰으로 인라인 텍스트와 인라인 컴포넌트의 글자 크기를 조절합니다. `{bg:}`/`{color:}`/`{palette:}` 와 같은 계열의 토큰이라 순서에 상관없이 함께 쓸 수 있습니다.

크기 값은 `xs` · `sm` · `lg` · `xl` · `xxl` 다섯 가지만 허용됩니다(기본 크기는 토큰 생략). 픽셀 등 자유 값은 조용히 무시됩니다 — 문서 간 크기 일관성과 안전성을 위한 제한입니다.

==큰 강조 텍스트==

==작은 부연==

[대형 배지]

```
{fs:xl}==큰 강조 텍스트==
{fs:sm}{color:gray}==작은 부연==
{fs:xxl}{palette:primary}{badge:대형 배지}
```

`==텍스트==` 형식 구문과 인라인 컴포넌트(`{badge:}` `{tag:}` `{button:}` `{stat:}` `{kbd:}` `{progress:}`)에 적용됩니다.

## 정렬 블록

문단·이미지·표·컴포넌트를 왼쪽/가운데/오른쪽으로 정렬하는 최소 컨테이너입니다. 타입은 `left` / `center` / `right` 세 가지이며, 내부에는 일반 문법을 그대로 쓸 수 있습니다.


가운데 정렬된 문단입니다.

[컴포넌트도 정렬]



오른쪽 정렬된 문단입니다.


```
:::center
가운데 정렬된 문단입니다.

{palette:primary}{badge:컴포넌트도 정렬}
:::

:::right
오른쪽 정렬된 문단입니다.
:::
```


---

## 타임스탬프

`{타임스탬프종류:시간}` 을 입력하면 타임스탬프로 변환됩니다.

지원하는 타임스탬프 종류 
- 디데이`dday`
지정한 날짜로부터 남은 날짜, 또는 지난 날짜수를 표시합니다. 당일의 경우 D-Day로 표시됩니다.
시간은 YYYY-MM-DD 형식 또는 MM-DD 형식으로 작성합니다.
- 나이`age`
생년월일 입력으로 만 나이를 표시합니다.
시간은 YYYY-MM-DD 형식으로 작성합니다.
- 시간`time`
특정 시간을 고정해 표시합니다.
시간은 유닉스 시간 정수로 작성합니다.
- 타이머`timer` 
특정 시간으로부터 남은 시간 또는 지난 시간을 표시합니다.
시간은 유닉스 시간 정수로 작성합니다.
- 달력`calendar`
특정 날짜를 달력으로 표시합니다.
YYYY-MM-DD 또는 MM-DD 형식으로 시간을 입력합니다. [* 연도 없이 날짜만 입력하는 경우, 날짜에 대한 유효성 검사가 생략됩니다. 8월 32일 등 실제로 없는 날짜를 표기할 수 있습니다.]









```
{dday:2026-03-09}
{dday:03-09}
{age:2007-08-31}
{time:1775394426}
{timer:1777987135}
{calendar:08-32}
{calendar:2026-03-09}
```

## 시점별 조건부 표시

`:::after 시각` 블록은 지정한 시각 **이후에만**, `:::until 시각` 블록은 지정한 시각 **이전에만** 본문을 표시합니다. 페이지를 열어둔 채 경계 시각을 지나면 자동으로 전환됩니다.

```
:::until 2030-01-01
행사 시작 전 안내입니다.
:::
:::after 2030-01-01
행사가 시작되었습니다!
:::
```

시각 형식 (타임스탬프와 동일한 관례)
- 유닉스 초 (예: `:::after 1775394426`) — 전 세계가 동일한 순간에 전환됩니다. 전역 컷오버에 권장.
- `YYYY-MM-DD` 또는 `YYYY-MM-DD HH:MM` — **보는 사람의 기기 시간대 기준**입니다. 날짜만 쓰면 그 날 0시.

주의사항
- **표시 전용 기능이며 비공개(엠바고) 수단이 아닙니다.** 숨겨진 분기의 원문도 검색과 AI 문서 열람에는 항상 노출됩니다. 특정 시점 전에 절대 공개되면 안 되는 내용에는 사용하지 마세요.
- 헤딩 번호와 섹션 링크 주소는 숨김 여부와 무관하게 양쪽 분기를 모두 세어 항상 동일하게 유지됩니다(섹션 링크 안정성). 숨겨진 분기의 헤딩·각주는 목차와 각주 목록에 나타나지 않고, 경계 통과 시 자동으로 나타납니다.
- 분기마다 다른 내용의 각주가 필요하면 분기별로 **서로 다른 이름 또는 익명 각주** `[* 내용]` 을 사용하세요. 이름 있는 각주 정의는 문서 전체에서 공유되므로(첫 정의 채택), 보이는 본문에서 `[*이름]` 을 참조하면 정의가 숨김 분기에 있어도 그 내용이 표시됩니다.

---

## 미디어 삽입


다양한 미디어 플랫폼의 콘텐츠를 `{embed:URL}` 형식으로 삽입할 수 있습니다.

**지원 서비스 목록**
-  YouTube
-  ニコニコ動画
-  Spotify



```
{embed:https://youtu.be/jQmYZWjLwzw}
```



```
{embed:https://nicovideo.jp/watch/sm2937784}
```



```
{embed:https://open.spotify.com/track/1k5F2EwzptN821wy7cPggG?si=9494bd33a24642cd}
```



불필요한 영상 뷰어 표시를 막기 위해 같은 줄에 다른 텍스트가 섞인 경우, 뷰어가 로드되지 않습니다.

테스트 
```
테스트 {embed:https://youtu.be/jQmYZWjLwzw}

```
예외적으로 `> 인용문`에는 임베딩을 사용할 수 있습니다.

> 

### 임베드 크기

임베드 URL 바로 뒤에 이미지와 동일한 어휘의 `{size:}` 토큰을 붙이면 뷰어의 최대 폭을 제한할 수 있습니다(가운데 정렬). 지원 값은 두 가지입니다.

- `{size:medium}` — 최대 640px
- `{size:small}` — 최대 420px



```
{embed:https://youtu.be/jQmYZWjLwzw}{size:small}
```

토큰을 생략하면 기존처럼 본문 전체 폭(16:9)으로 표시됩니다. YouTube·ニコニコ動画・Spotify·Google Maps 임베드 모두에 적용됩니다.

## 지도 삽입

구글 지도 임베드 링크를 붙여넣으면 지도가 삽입됩니다.



```
{embed:https://www.google.com/maps/embed?pb=!1m18!1m12!1m3!1d380514.6269296274!2d-88.06153207605908!3d41.833239273665306!2m3!1f0!2f0!3f0!3m2!1i1024!2i768!4f13.1!3m3!1m2!1s0x880e2c3cd0f4cbed%3A0xafe0a6ad09c0c000!2z66-46rWtIOydvOumrOuFuOydtCDsi5zsubTqs6A!5e0!3m2!1sko!2skr!4v1776126803127!5m2!1sko!2skr}
```

# 컴포넌트

[[Cloudwiki/위키 문법 가이드/컴포넌트]] 문서를 참고하세요.

# 차트 • 다이어그램

` ```mermaid ` 코드 블록으로 다이어그램(플로우차트·시퀀스·간트·ER 등), 표시할 그래프를 작성하는 방법은 [[Cloudwiki/위키 문법 가이드/차트]] 문서를 참고하세요.