# 위키 문법

## 개요
위키 문법(Wiki Syntax)은 위키 웹사이트에서 콘텐츠를 작성하고 형식을 지정하기 위해 사용되는 가벼운 마크업 언어입니다. 이는 HTML과 같은 전통적인 프로그래밍 언어보다 간단한 규칙을 기반으로 하여, 비전문가도 쉽게 문서를 생성하고 편집할 수 있도록 설계되었습니다. 위키 문법은 주로 **텍스트 기반의 형식 지정**을 지원하며, 다양한 위키 플랫폼(예: MediaWiki, DokuWiki)에서 공통적으로 사용되는 표준 규칙을 포함합니다.

## 기본 구조 및 요소

### 제목 (Heading)
제목은 `=` 기호를 사용하여 정의됩니다.  
- 단일 수준 제목: `== 제목 ==`  
- 이중 수준 제목: `=== 서브제목 ===`  

예시:
```wiki
== 주요 제목 ==
=== 하위 제목 ===
```

### 문단 (Paragraph)
문단은 줄바꿈을 통해 자동으로 구분됩니다. 별도의 태그가 필요하지 않습니다.  
예시:
```
이것은 첫 번째 문단입니다.
두 번째 문단입니다.
```

### 목록 (List)
- **순서 있는 목록**: 숫자와 점 (`1.`, `2.`)으로 시작  
- **순서 없는 목록**: 하이픈 (`*`) 또는 별표 (`+`)로 시작  

예시:
```wiki
1. 첫 번째 항목
2. 두 번째 항목

* 순서 없는 목록 1
* 순서 없는 목록 2
```

## 형식 지정 기능

### 강조 (Formatting)
- **볼드**: `'''강조 텍스트'''`  
- *이탈릭*: `''이탈릭 텍스트''`  
- **코드**: `{{{코드 블록}}}` 또는 `{{코드}}`  

예시:
```
'''이것은 볼드입니다.'''
''이것은 이탈릭입니다.''
```

### 링크 (Link)
- **내부 링크**: `[문서 이름]`  
- **외부 링크**: `[https://example.com 외부 사이트]`  

예시:
```wiki
[위키 문법 문서]
[https://ko.wikipedia.org/wiki/위키 위키 위키]
```

### 이미지 삽입 (Image)
이미지는 `[[파일:이름.jpg]]` 형식으로 삽입됩니다.  
예시:
```
[[파일:example.jpg]]
```

## 고급 기능

### 템플릿 (Template)
템플릿은 반복적인 콘텐츠를 재사용하기 위해 사용됩니다. 일반적으로 `{{템플릿 이름|매개변수}}` 형식입니다.  
예시:
```wiki
{{참고문서|제목=위키 문법|내용=자세한 설명}}
```

### 매크로 (Macro)
매크로는 특정 기능을 수행하는 코드 조각으로, `[[macro:이름]]` 형식입니다. 예를 들어, 날짜 표시나 계산 기능에 사용됩니다.

### 테이블 (Table)
테이블은 `{| ... |}` 구조로 작성되며, 행과 열을 `|` 기호로 구분합니다.  
예시:
```wiki
{| border="1"
| 이름 || 나이
| 김철수 || 30
| 이영희 || 25
|}
```

## 예제: 완전한 문서 구성
```wiki
== 제목 ==
=== 서브제목 ===

이것은 첫 번째 문단입니다.
* 목록 항목 1
* 목략 항목 2

'''볼드 텍스트'''
''이탈릭 텍스트''

[내부 링크]
[[파일:example.jpg]]

{{참고문서|제목=위키 문법|내용=자세한 설명}}
```

## 참고 자료
- [MediaWiki 공식 문서](https://www.mediawiki.org/wiki/Help:Formatting)
- [DokuWiki 문법 가이드](https://www.dokuwiki.org/dokuwiki)
- 위키 플랫폼별 차이점 분석 (예: MediaWiki vs. TiddlyWiki)

위키 문법은 단순함과 유연성을 바탕으로, 협업 및 지식 공유를 위한 강력한 도구로 자리 잡았습니다. 구체적인 기능은 사용하는 위키 소프트웨어에 따라 다를 수 있으므로, 해당 플랫폼의 문서를 참고하는 것이 중요합니다.