도움말:위키 문법/1단계: 두 판 사이의 차이

2025년 2월 16일 (일) 14:30 기준 최신판

가온 위키 프로젝트
이 문서는 가온 위키 프로젝트를 설명하는 문서입니다.

위키를 시작하는데 도움이 되는 정보를 얻을 수 있습니다. 빠르게 위키를 배우고 싶다면 위키 도움이 틀을 찾아가세요!
위키 도움이

위키 문법
기초			중급				심화				기타
1단계	→	2단계	→	3단계	→	4단계	→	5단계	→	심화	/	이런 것도 있다고요

위키 문법의 가장 기초적이고 자주 사용되는 요소들을 설명합니다. 이 문서에서 다루는 문법들은 위키 편집에서 가장 빈번하게 사용되는 핵심 기능들입니다.

1. 문단 구분[원본 편집]

문단을 구분하려면 엔터키를 두 번 눌러 빈 줄을 삽입합니다.

입력 예시:

첫 번째 문단입니다.
이렇게 한 번만 줄바꿈하면 같은 문단으로 처리됩니다.

두 번째 문단입니다.
엔터를 두 번 쳐서 새로운 문단을 만들었습니다.

결과: 첫 번째 문단입니다. 이렇게 한 번만 줄바꿈하면 같은 문단으로 처리됩니다.

두 번째 문단입니다. 엔터를 두 번 쳐서 새로운 문단을 만들었습니다.

2. 제목 만들기[원본 편집]

등호(=)를 사용하여 제목의 단계를 표시합니다. 등호는 양쪽에 같은 개수로 입력합니다.

입력 예시:

== 2단계 제목 ==
=== 3단계 제목 ===
==== 4단계 제목 ====
===== 5단계 제목 =====

결과:

3단계 제목[원본 편집]

4단계 제목[원본 편집]

5단계 제목[원본 편집]

참고: 1단계 제목(=)은 문서의 제목으로 사용되므로, 본문에서는 2단계 제목부터 사용하는 것이 좋습니다.

3. 글자 서식[원본 편집]

작은따옴표(')를 사용하여 글자의 서식을 지정할 수 있습니다.

입력 예시:

''기울임체''
'''굵은 글씨'''
'''''굵은 기울임체'''''

결과: 기울임체 굵은 글씨 굵은 기울임체

4. 목록 만들기[원본 편집]

별표(*)나 샵(#)을 사용하여 목록을 만들 수 있습니다.

입력 예시:

* 순서 없는 목록
* 두 번째 항목
** 들여쓴 항목
** 다른 들여쓴 항목
* 다시 첫 수준

# 순서 있는 목록
# 두 번째 항목
## 들여쓴 항목
## 다른 들여쓴 항목
# 다시 첫 수준

* 혼합 목록
*# 순서 있는 하위 항목
*# 두 번째 순서 항목
* 다시 순서 없는 목록

결과:

순서 없는 목록
두 번째 항목
- 들여쓴 항목
- 다른 들여쓴 항목
다시 첫 수준

순서 있는 목록
두 번째 항목
1. 들여쓴 항목
2. 다른 들여쓴 항목
다시 첫 수준

혼합 목록
1. 순서 있는 하위 항목
2. 두 번째 순서 항목
다시 순서 없는 목록

5. 링크 만들기[원본 편집]

내부 링크[원본 편집]

대괄호([])를 사용하여 다른 위키 문서로 연결하는 링크를 만듭니다.

입력 예시:

[[문서 이름]]
[[문서 이름|다른 이름으로 표시]]

결과: 문서 이름 다른 이름으로 표시

외부 링크[원본 편집]

한 개의 대괄호를 사용하여 외부 웹사이트로 연결하는 링크를 만듭니다.

입력 예시:

[https://www.example.com]
[https://www.example.com 예시 웹사이트]

결과: [1] 예시 웹사이트

6. 수평선[원본 편집]

하이픈(-)을 4개 이상 연속해서 입력하면 수평선이 생성됩니다.

입력 예시:

문단 1
<hr>
문단 2

결과: 문단 1

문단 2

7. 목차 제어[원본 편집]

문서에 제목이 4개 이상 있으면 자동으로 목차가 생성됩니다. 다음 매직워드를 사용하여 목차를 제어할 수 있습니다:

목차
: 이 위치에 목차를 강제로 표시
: 목차를 숨김

참고: 목차는 모든 제목을 포함하며, 문서의 구조를 한눈에 파악하는데 도움이 됩니다.

기타 도움말[원본 편집]

문법은 대소문자를 구분하지 않습니다(예: text와 TEXT는 동일하게 작동)
여러 문법을 조합해서 사용할 수 있습니다(예: 링크된 굵은 텍스트)
문서 시작 부분에 간단한 소개나 설명을 넣는 것이 좋습니다
제목은 계층 구조를 지켜서 사용하세요(2단계 다음에 4단계를 쓰는 것은 피하세요)

연습하기[원본 편집]

위의 문법들을 실제로 사용해보면서 익숙해지는 것이 중요합니다. 연습장에서 다양하게 시도해보세요.

@@ 1번째 줄: / 1번째 줄: @@
-{{틀:위키프로젝트}}<br/>
+{{틀:위키프로젝트}}
-{{틀:위키도움이}}<br/>
+{{틀:위키도움이}}
 {{틀:위키 문법 단계}}
-==이 단계의 목표==
+위키 문법의 가장 기초적이고 자주 사용되는 요소들을 설명합니다. 이 문서에서 다루는 문법들은 위키 편집에서 가장 빈번하게 사용되는 핵심 기능들입니다.
-* 문서를 생성 할 수 있다.
-* 문단을 생성 할 수 있다.
-* 간단하게 글을 꾸밀 수(?) 있다.
-==문서 생성==
+== 1. 문단 구분 ==
-문서를 생성하는 방법은 매우 쉬워요. 일단 문서를 생성하려면 원하는 문서명이 존재하는지 확인해야 해요.
+문단을 구분하려면 엔터키를 두 번 눌러 빈 줄을 삽입합니다.
-중복된 문서는 생성 할 수 없기 때문이에요. (여기서는 없다고 가정하였습니다.)
-[[가온 위키]]의 편집 정책에 의해 '''로그인 후 문서 생성/편집'''이 가능해요. 만약 가온 위키의 계정이 없으신 분들은 로그인 해주세요.
+입력 예시:
+<pre>
+첫 번째 문단입니다.
+이렇게 한 번만 줄바꿈하면 같은 문단으로 처리됩니다.
-로그인 후 원하는 문서명을 검색해 주세요.
+두 번째 문단입니다.
-그 다음 '''이 위키에 "{{틀:글씨 색|red||입력한 문서명}}" 문서를 만드세요!''' 이란 문장이 나타나요. 문장 중, 빨간색 글자를 누르면 문서 생성 준비 끝!
+엔터를 두 번 쳐서 새로운 문단을 만들었습니다.
+</pre>
-문서에 내용을 적고, 요약 부분에 내용을 간단히 적은 뒤, '''{{틀:글씨 색|white|blue|문서 저장}}''' 버튼을 눌러 저장하면 문서를 생성 할 수 있어요.
+결과:
+첫 번째 문단입니다.
+이렇게 한 번만 줄바꿈하면 같은 문단으로 처리됩니다.
-==문단 만들기==
+두 번째 문단입니다.
-책이나 논문과 같은 글들을 보면 문단이 나뉘여 있는 것처럼 위키에서도 문단을 나누면 다른 사용자들이 문서를 한눈에 볼 수 있어요.
+엔터를 두 번 쳐서 새로운 문단을 만들었습니다.
-문단을 만드는 방법은 엄청 쉬워요. 원하는 문단명을 "="를 사용하여 만들어 낼 수 있습니다.
+== 2. 제목 만들기 ==
-즉 '''<nowiki>==문단명===</nowiki>''' 이런 형식으로 사용하면 돼요.
+등호(=)를 사용하여 제목의 단계를 표시합니다. 등호는 양쪽에 같은 개수로 입력합니다.
-'''='''의 개수가 많아질수록 하위 문단으로 인식됩니다. 최대 6개까지 사용 할 수 있고, 7개 이상 사용한 경우, 6개는 문단으로 사용되고, 나머지는 하나의 문자로 표시돼요.
+입력 예시:
+<pre>
+== 2단계 제목 ==
+=== 3단계 제목 ===
+==== 4단계 제목 ====
+===== 5단계 제목 =====
+</pre>
-또한 '''=''' 1개만 사용하면 안돼요.
+결과:
-'''반드시 "="는 2개 이상, 6개 이하로만 사용해야 돼요.'''
+=== 3단계 제목 ===
+==== 4단계 제목 ====
+===== 5단계 제목 =====
-==줄 바꾸기==
+'''참고:''' 1단계 제목(=)은 문서의 제목으로 사용되므로, 본문에서는 2단계 제목부터 사용하는 것이 좋습니다.
-글이 길어지면 보기에 좋지 않아요. 그래서 줄을 바꿔서 보기 편하기 하죠.
-줄 바꾸기를 통해 가독성을 높여보도록 하죠.
-위키에서 줄을 바꾸는 방법은 두 가지가 있어요.
+== 3. 글자 서식 ==
-:엔터를 두 번 누르는 방법
+작은따옴표(')를 사용하여 글자의 서식을 지정할 수 있습니다.
-:줄을 바꾸고 싶은 부분 바로 앞에 <nowiki><br/></nowiki>을 입력하는 방법.
-엔터를 두 번 눌러 줄을 바꾸는 것을 권장해요. <nowiki><br/></nowiki> 태그를 문장마다 붙여 놓으면 다른 사람들이 편집하기 힘들기 때문이에요.<ref>하지만 지나친 ''엔터 두번 입력''은 오히려 편집을 어렵게 해요.</ref>
+입력 예시:
+<pre>
+''기울임체''
+'''굵은 글씨'''
+'''''굵은 기울임체'''''
+</pre>
-또한 <nowiki><br/></nowiki>은 특히 모바일 편집 시 불편하게 해요. 그래서 웬만하면 엔터 키를 두 번 누르는 습관을 길러야 해요.
+결과:
+''기울임체''
+'''굵은 글씨'''
+'''''굵은 기울임체'''''
-다만 <nowiki><br/></nowiki>을 반드시 사용해야 하는 경우도 있어요. 대표적인 예로 표 내용에서의 줄 바꿈 이에요.
+== 4. 목록 만들기 ==
-표 안에서는 엔터 두 번 입력이 작동하지 않기 때문에, <nowiki><br/></nowiki>을 입력해야 줄이 바뀌어요.
+별표(*)나 샵(#)을 사용하여 목록을 만들 수 있습니다.
-==글씨 꾸미기==
+입력 예시:
-위키 문서를 그냥 작성하기에는 밋밋한 글자들이 많아요. 특정 부분을 강조하거나, 색을 변경하고 싶을 때에는 어떻게 해야 좋을까요?
+<pre>
+* 순서 없는 목록
+* 두 번째 항목
+** 들여쓴 항목
+** 다른 들여쓴 항목
+* 다시 첫 수준
-위키에서는 꾸미는 기능이 몇 가지 있습니다. 하나하나씩 살펴보도록 해요.
+# 순서 있는 목록
+# 두 번째 항목
+## 들여쓴 항목
+## 다른 들여쓴 항목
+# 다시 첫 수준
-===글씨 굵게(볼드)===
+* 혼합 목록
-글씨를 굵게 하려면, 굵게 하고 싶은 부분 양 끝에 <nowiki>'''</nowiki>를 붙여 보세요.
+*# 순서 있는 하위 항목
-예를 들어 <nowiki>'''굵게'''</nowiki> 라고 작성하였다면, '''굵게''' 표시 되어요.
+*# 두 번째 순서 항목
+* 다시 순서 없는 목록
+</pre>
-굵게 처리하는 목적은 주로 '''중요 부분을 강조하려는 목적'''이에요. 따라서 중요한 부분이라고 생각되면 이 방식을 사용하면 돼요.
+결과:
+* 순서 없는 목록
+* 두 번째 항목
+** 들여쓴 항목
+** 다른 들여쓴 항목
+* 다시 첫 수준
-===글씨 기울이기===
+# 순서 있는 목록
-글씨를 기울일 수도 있어요. 글씨를 굵게 하는 방식과 비슷해요. 양 끝에 <nowiki>''</nowiki>를 붙히면 끝.
+# 두 번째 항목
+## 들여쓴 항목
+## 다른 들여쓴 항목
+# 다시 첫 수준
-예를 들어 <nowiki>''기울여진 글''</nowiki>이라고 작성하였으면, ''기울여진 글'' 이라고 표시 돼요.
+* 혼합 목록
+*# 순서 있는 하위 항목
+*# 두 번째 순서 항목
+* 다시 순서 없는 목록
-혹시 굵으면서 기울이고 싶으신가요? 양 끝에 <nowiki>'''''</nowiki>를 붙히면 됩니다.
+== 5. 링크 만들기 ==
-예를 들어 <nowiki>'''굵으면서''' ''기울이는 글자는'' '''''이렇게 하면 돼요!'''''</nowiki> 라고 입력하면 '''굵으면서''' ''기울이는 글자는'' '''''이렇게 하면 돼요!''''' 라고 나와요.
+=== 내부 링크 ===
+대괄호([])를 사용하여 다른 위키 문서로 연결하는 링크를 만듭니다.
-===글자 크기 조절===
+입력 예시:
-한글이나 워드에서는 폰트 크기를 자유롭게 조절할 수 있는데요.
+<pre>
-위키에서는 워드보다는 덜 자유롭지만, 글자 크기를 조절 할 수 있습니다. 글자의 크기 포인트를 설정 할 수 없고, 한 단계 키우는 방식으로 글자의 크기를 키울 수 있어요.
+[[문서 이름]]
+[[문서 이름|다른 이름으로 표시]]
+</pre>
-글자 크기를 키우고 싶은 곳 앞에 <nowiki><big></nowiki>를, 뒤에는 <nowiki></big></nowiki>를 붙이면 돼요.
+결과:
-예를 들면, <big>크게 쓰기!</big>
+[[문서 이름]]
+[[문서 이름|다른 이름으로 표시]]
-반대로 크기를 줄일 수도 있습니다. <nowiki><small></small></nowiki>를 사용하면 되죠.
+=== 외부 링크 ===
-<nowiki><big></nowiki> 태그를 중복해서 사용 가능해요. <nowiki><big><big>이거 가능해요!</big></big></nowiki>라 입력하면, <big><big>이거 가능해요!</big></big> 라고 떠요.
+한 개의 대괄호를 사용하여 외부 웹사이트로 연결하는 링크를 만듭니다.
-===취소선 긋기===
+입력 예시:
-처음 작성한 이후 변경 사항이 있는 경우(변경사항의 내용 양이 적은 경우에만), 취소선을 사용하면 돼요. 변경사항용 뿐만 아니라 드립용으로도 사용이 가능해요. <s>취소선을 취소한다</s>
+<pre>
+[https://www.example.com]
+[https://www.example.com 예시 웹사이트]
+</pre>
-가온 위키와 같은 위키 엔진을 쓰는 [[리브레 위키]]에서는 이 방법 이외에 <nowiki>{{ㅊ|}}</nowiki> 태그를 사용할 수 있어요.
+결과:
-하지만 가온 위키에서는 해당 태그 사용을 하지 말아주세요.<ref>해당 태그는 타 유저들의 편집에 혼란을 줄 수 있기 때문.</ref>
+[https://www.example.com]
+[https://www.example.com 예시 웹사이트]
-사용 할 수 있는 방식은 2가지 방식이 있습니다. <nowiki><del></del></nowiki> 과 <nowiki><s></s></nowiki> 인데요.
+== 6. 수평선 ==
+하이픈(-)을 4개 이상 연속해서 입력하면 수평선이 생성됩니다.
-둘의 결과는 동일합니다. 따라서 아무것이나 사용해도 상관 없어요.
+입력 예시:
-하지만 문서별로 통일하여 사용해 주세요. 나중에 문서를 수정할 때에 헷갈릴 수 있기 때문이에요.
+<pre>
+문단 1
+----
+문단 2
+</pre>
-===밑줄 긋기===
+결과:
-밑줄 긋기는 글자 굵게 하는 것과 마찬가지로 중요한 부분에 사용하면 돼요.
+문단 1
-사용하는 태그는 <nowiki><u></u></nowiki> 이에요.
+----
+문단 2
-이런 식으로 <u>사용하면</u> 돼요.
+== 7. 목차 제어 ==
+문서에 제목이 4개 이상 있으면 자동으로 목차가 생성됩니다. 다음 매직워드를 사용하여 목차를 제어할 수 있습니다:
-===글자 관련 색상===
+* __TOC__ : 이 위치에 목차를 강제로 표시
-글자 색상과 글자 배경색을 변경할 수 있어요!
+* __NOTOC__ : 목차를 숨김
-<nowiki>{{글씨 색|글씨 색|배경 색|내용}}</nowiki> 형식으로 써주시면 됩니다.
-예를 들어 <nowiki>{{글씨 색|red|blue|이렇게요!}}</nowiki>라 입력하면, {{글씨 색|red|blue|이렇게요!}} 이렇게 떠요.
+'''참고:''' 목차는 모든 제목을 포함하며, 문서의 구조를 한눈에 파악하는데 도움이 됩니다.
-==목록을 만들어보자!==
+== 기타 도움말 ==
-문서를 보다보면 문장 첫부분에 '1.', '2.'와 같이 숫자와 '·'과 같이 점으로 시작하는 걸 볼 수 있는데요.
+* 문법은 대소문자를 구분하지 않습니다(예: ''text''와 ''TEXT''는 동일하게 작동)
+* 여러 문법을 조합해서 사용할 수 있습니다(예: '''[[링크된 굵은 텍스트]]''')
+* 문서 시작 부분에 간단한 소개나 설명을 넣는 것이 좋습니다
+* 제목은 계층 구조를 지켜서 사용하세요(2단계 다음에 4단계를 쓰는 것은 피하세요)
-숫자로 시작하는 것을 '''ordered list'''<ref>HTML 태그의 <nowiki><ol></nowiki>태그</ref>, ·으로 시작하는 것을 '''unordered list'''<ref>HTML 태그의 <nowiki><ul></nowiki> 태그'''</ref>라 해요.
+== 연습하기 ==
+위의 문법들을 실제로 사용해보면서 익숙해지는 것이 중요합니다. [[가온 위키:연습장|연습장]]에서 다양하게 시도해보세요.
-ordered list 방식은 문장 앞에 <nowiki>#</nowiki>를 붙히면 숫자가 나와요. 붙힌 순서대로 숫자가 시작해요. <nowiki>#</nowiki>와 문장(또는 단어) 사이는 한칸만 띄우면 돼요.
-unordered list 방식은 문장 앞에 <nowiki>*</nowiki>를 붙히면 ·이 나와요. 순서와 관계없으므로 모두 다 ·으로 나와요. <nowiki>#</nowiki>와 마찬가지로 문장(또는 단어) 사이에는 한칸만 띄워요.
-==분기==
-{{분기|도움말:위키 문법|4839||가온 위키}}
-==각주==