Cloudwiki/위키 문법 가이드/요약본(AI용)
제목: Cloudwiki/위키 문법 가이드/요약본-AI용
# Cloudwiki 문법 — AI 에이전트 축약 레퍼런스
> 이 문서는 AI 에이전트가 Cloudwiki 문서를 작성·편집할 때 빠르게 참조하기 위한 압축본입니다.
> 전체 가이드: [[Cloudwiki/위키 문법 가이드]], [[Cloudwiki/위키 문법 가이드/컴포넌트]]
---
## 주의사항
- 헤딩(`##`, `###` 등)에 번호를 직접 적지 말 것. 위키가 자동 부여함. (`## 1. 개요` ❌ → `## 개요` ✅)
- 코드 블록 내부는 위키 문법이 동작하지 않음.
---
## 1. 기본 마크다운 (Cloudwiki 전용 확장만 주의)
표준 마크다운과 동일하나, 아래는 Cloudwiki 전용 확장이므로 별도 숙지.
```
==형광펜== __밑줄__
{size:icon|small|medium|full}
icon은 텍스트 인라인 삽입 가능. {size:} 옵션은 생략 가능 (생략시 full과 동일)
표 셀 병합 (Cloudwiki 전용):
{>} 오른쪽 병합 {<} 왼쪽 병합 {^} 위 병합 {><} 가운데로 병합
※ 색상 문법은 병합 셀이 아닌 일반 내용 칸에 작성
표 셀 안 줄바꿈 (Cloudwiki 전용):
{br} 을 셀 안에 인라인으로 삽입하면 셀 내부에서 줄바꿈이 적용됨.
표준 마크다운은 표 셀이 단일 라인이어야 하므로 직접 줄바꿈 불가.
에디터에서 셀 안에 커서를 두고 Shift+Enter 로 {br} 빠르게 삽입 가능.
```
---
## 2. 위키 확장 문법
### 위키 내부 링크
```
[[문서제목]]
[[문서제목|표시텍스트]]
[[문서제목#1.1]] ← 특정 목차로 이동
[[문서제목#1.1|표시텍스트]]
```
### 틀 (Transclusion)
```
{{틀:틀이름}}
{{틀:틀이름|파라미터=값|파라미터2=값2}}
```
틀 본문에서: `{{{파라미터이름}}}` 으로 파라미터 수신.
### 아이콘
```
{bi:아이콘이름} Bootstrap Icons
{mdi:아이콘이름} Material Design Icons
```
### 각주
```
텍스트[* 각주 내용. **마크다운** 가능.]
```
### 펼치기/접기
```
[+ 버튼 제목]
숨겨진 내용 (마크다운 동작)
[-]
[+ {bg:#색상} {color:#색상} 커스텀 제목]
내용
[-]
```
### 색상 · 팔레트
```
인라인 텍스트:
{color:#FF0000}==텍스트==
{bg:#000}{color:#FFF}==텍스트==
표 셀:
| {bg:red}{color:white} 내용 | ...
팔레트 프리셋: primary / secondary / success / info / warning / danger / muted
{palette:primary}
팔레트 뒤에 {bg:}/{color:} 붙이면 해당 속성 덮어쓰기 가능.
```
> ⚠ 배경/글씨 중 하나만 설정하면 다크 모드 가독성 문제가 생길 수 있으므로 둘 다 설정 권장.
### 타임스탬프
```
{dday:YYYY-MM-DD} 또는 {dday:MM-DD}
{age:YYYY-MM-DD}
{time:유닉스타임}
{timer:유닉스타임}
{calendar:YYYY-MM-DD} 또는 {calendar:MM-DD}
```
### 미디어 삽입
줄 단독으로 URL을 붙여넣으면 자동 임베드. 지원: YouTube, ニコニコ動画, Spotify, Google Maps.
임베딩을 막으려면 `<URL>` 또는 `[텍스트](URL)` 마크다운 형식 사용.
---
## 3. 인라인 컴포넌트
모든 컴포넌트 기본 구조: `{[아이콘]}{[색상]}{컴포넌트:내용}`
```
{badge:텍스트} ← 배지 (기본 크기 칩)
{tag:텍스트} ← 태그 (소형 칩)
{stat:값|제목} ← 스탯 (제목+내용 칩)
{button:텍스트|URL} ← 링크 버튼
{kbd:Ctrl+S} ← 키보드 키 (+ 로 조합키)
{progress:70} ← 진행도 바 (0~100 또는 a/b)
{progress:7/10|라벨}
{hr} ← 인라인 가로선 (블록 내부 사용 가능)
```
색상 적용 예:
```
{palette:primary}{badge:텍스트}
{bi:star}{palette:warning}{stat:5|평점}
{color:#0f0}{progress:80|완료율}
```
---
## 4. 블록 컴포넌트 (:::지시어)
블록 내부에 다른 블록 중첩 가능. 단, `grid`/`row` 중첩은 비권장.
### 카드
```
:::card {palette:팔레트} 카드 제목
{palette:success}본문 내용
:::
```
### 콜아웃
타입: `info` / `tip` / `success` / `warning` / `danger` / `note`
```
:::info
안내 내용
:::
:::warning 커스텀 제목
주의 내용
:::
```
헤더 색 변경: `:::warning {palette:...} 제목` / 본문 색: 본문 첫 줄에 `{palette:...}` 추가.
### 임베드
```
:::embed 제목 {palette:reverse}
https://youtu.be/...
설명 텍스트
:::
:::embed
제목·색 생략 시 기본 강조선 박스
:::
```
### 그리드 / row
```
:::grid
인라인 컴포넌트들 또는 표 (반응형 배치)
:::
:::row
인라인 컴포넌트들 또는 표 (가로 스크롤 고정 배치)
:::
```
### 탭
```
:::tabs
:::tab 탭1 {icon:bi-아이콘}
내용
:::
:::tab 탭2
내용
:::
:::
```
### 아코디언
```
:::accordion ← 단일 열림 모드 (기본)
:::accordion {multiple} ← 다중 열림 모드
:::item 제목 {open} {icon:bi-아이콘}
내용
:::
:::item 제목2
내용
:::
:::
```
### 스탭 (Steps)
```
:::steps
:::step 제목 {status:done}
내용
:::
:::step 제목 {status:current}
내용
:::
:::step 제목
내용 (기본 status: todo)
:::
:::
```
상태값: `done` (완료) / `current` (진행 중) / `todo` (미진행, 기본값)