위키 문법이란 미디어위키 소프트웨어에서 쓰이는 구문과 키워드를 이용하여 문서를 꾸미는 방법 및 규칙을 말합니다.
개요
이 글은 위키백과의 문서 작성에 필수적이거나, 편집할 때 유용하게 사용할 수 있는 위키 문법에 대해 설명하고 있습니다.[보충설명 1]
미디어위키는 복잡한 마크업[보충설명 2]의 사용을 피하기 위해 문단과 줄의 바뀜이나 굵은 글씨나 기울임 글씨의 표현과 같은 단순한 편집은 별도의 마크업 없이 처리하고 있습니다. 예를 들어 이어지는 글의 문단을 바꾸고자 할 때에는 단순히 엔터를 두 번 입력하면 됩니다. 그러나, 특수 문자나 기호의 표시나 수식의 표현, 글자의 정렬과 같은 기능을 위해 자체 마크업을 사용합니다.
위키백과의 문법을 설명하는 이 글의 본문에서는 입력한 내용과 결과가 제시되어 있습니다. 입력한 내용에 나타나 있는 대로 편집란에 입력한 후 미리보기 버튼이나 저장 버튼을 누르면 그에 따른 결과가 표시됩니다. 이 글에서 설명하고 있는 기능을 직접 연습하고 싶다면 연습장을 이용하시기 바랍니다. 연습장을 사용한 후에는 다음 사람을 위해 작성하신 내용을 비워주시기 바랍니다.
보충설명
↑위키백과의 사용과 관련한 다른 도움말은 다음과 같은 것들이 있습니다. 아직 위키백과의 편집에 익숙하지 않다면 한 번 읽어보시기 바랍니다.
↑마크업은 마크업 언어에서 사용되는 데이터 처리 지시자를 말합니다. 대표적인 마크업으로는 HTML에서 사용되는 태그가 있습니다. 미디어위키의 마크업은 이와 유사한 방식으로 사용됩니다.
배치
요약: 이 문단에서는 다음의 것들을 설명하고 있습니다.
문단 나누기
목차의 표시
줄넘김
들여쓰기
문장의 정렬 방식
목록 표시하기
문단
문단(단락)은 하나의 글을 여러 개로 나눈 글의 단위입니다. 문단을 사용하면 목차에 그 문단의 제목(머릿글)이 표시됩니다. 여러분은 바로 이 문서에도 목차에 문단 제목이 표시되어 있다는 것을 확인하실 수 있습니다. 문단은 문서의 내용을 쉽게 읽고 이해할 수 있도록 하기 위해 사용합니다.
문단 머릿글
글의 내용을 여러 문단으로 나누기 위해 문단 머릿글을 사용합니다. 문단에는 적절한 머릿글이 있어야 합니다. 자동으로 생성되어 문서의 표제어를 나타내는 1단계 머릿글을 빼면, 2단계 머릿글이 편집자가 문서 내에서 쓸 수 있는 최고 단계의 머릿글입니다. 아래의 예와 같이 2단계 머릿글은 “==” 사이에 쓰면 됩니다. 더 작은 하위 문단의 머릿글은 “=”의 수를 늘려 표시합니다. 3단계는 “===” 사이에, 4단계는 “====” 사이에 머릿글을 쓰면 됩니다.
입력한 내용
화면에 표시되는 내용
== 문단 머릿글 ==''머릿글''을 이용하여 문단을 구분해 내용을 입력할 수 있습니다. 위키 소프트웨어는 이를 이용하여 자동으로 목차를 구성하게 됩니다. 두 개의 등호 입력으로 시작됩니다.
=== 하위 문단 ===
등호를 더 사용하면 하위 문단이 만들어집니다.
==== 더 작은 하위 문단 ====
두 개에서 바로 네 개의 등호로 단계를 건너뛰지 마세요.
문단 머릿글
머릿글을 이용하여 문단을 구분해 내용을 입력할 수 있습니다.
위키 소프트웨어는 이를 이용하여 자동으로 목차를 구성하게 됩니다.
두 개의 등호 입력으로 시작됩니다.
하위 문단
등호를 더 사용하면 하위 문단이 만들어집니다.
더 작은 하위 문단
두 개에서 바로 네 개의 등호로 단계를 건너뛰지 마세요.
구분선
※문서 본문에서는 사용하지 마십시오.
문단 머릿글에 자동 삽입되어 구분선으로 문단을 나눕니다. {{사이드바}} 틀 등에서 일부 특수한 경우 사용됩니다.
입력한 내용
화면에 표시되는 내용
'''구분선'''
수평의 구분선으로 문서를 나눕니다:<br />
:이것이 구분선 위쪽이고...
----
:...이것이 구분선 아래쪽입니다.
만일 문단 머릿글을 사용하지 않으면, 목차가 자동으로 생성되지 않습니다.
구분선
수평의 구분선으로 문서를 나눕니다:
이것이 구분선 위쪽이고...
...이것이 구분선 아래쪽입니다.
만일 문단 머릿글을 사용하지 않으면, 목차가 자동으로 생성되지 않습니다.
목차의 표시
문서에 네 개 이상의 문단이 있을 경우, 문서의 개요와 첫 문단 사이에 자동으로 목차가 나타나게 됩니다.
목차의 위치를 바꾸고 싶을 때에는 문서의 어느 곳이든 <div>__TOC__</div> 를 적으면 기본 위치가 아니라 <div>__TOC__</div> 를 적은 위치에 목차가 표시됩니다.
문서의 어떤 곳이든 <div>__NOTOC__</div> 를 적으면 목차가 사라집니다.
보충설명
위키백과에서 사용되는 마크업 언어인 미디어위키는 일부 HTML 태그를 허용합니다. 위에서 설명한 〈div〉도 그 가운데 하나입니다. 어떠한 HTML 태그가 허용되는지 보다 자세한 정보를 원하시면 m:Help:HTML in wikitext를 참조하시기 바랍니다.
줄 넘김
위키백과에서 문단을 구분하거나 줄을 바꿀 때에는 엔터키를 두 번 입력합니다.
입력한 내용
결과
한 번 줄을 넘겨도
글 배치에는 영향을 주지 않습니다.
하지만 내용이 없는 한 줄은 새로운 문단을 시작하게 하거나,
목록이나 글을 원하는 위치에서 끝내줍니다.
한 번 줄을 넘겨도
글 배치에는 영향을 주지 않습니다.
하지만 내용이 없는 한 줄은 새로운 문단을 시작하게 하거나,
목록이나 글을 원하는 위치에서 끝내줍니다.
이유가 없는 한 목록의 항목 사이에 빈 줄을 두지 마십시오. 이렇게 하면 미디어위키 소프트웨어가 각 항목을 새 목록을 시작하는 것으로 해석하게 됩니다.
입력한 내용
결과
* 정렬되지 않은 목록은 만들기 쉽습니다:
** 매 문자열마다 별표로 시작합니다.
**: 2단계 목록에 이어지는 내용
*** 별이 많을 수록 더 깊은 단계를 표시합니다.
***: 3단계 목록에 이어지는 내용
** 새로운 문자열이
* 목록 중에 나타나면
그 목록이 끝났음을 나타냅니다.
*물론 다시 시작할 수 있습니다.
정렬되지 않은 목록은 만들기 쉽습니다:
매 문자열마다 별표로 시작합니다.
2단계 목록에 이어지는 내용
별이 많을 수록 더 깊은 단계를 표시합니다.
3단계 목록에 이어지는 내용
새로운 문자열이
목록 중에 나타나면
그 목록이 끝났음을 나타냅니다.
물론 다시 시작할 수 있습니다.
# 번호가 매겨진 목록은:
## 체계적이고
## 흐름을 따르기 쉽습니다.
##: 2단계 번호 목록에 이어지는 내용
새로운 문자열은 그 목록이 끝났음을 나타냅니다.
# 다시 만들면 새 번호 1부터 시작합니다.
번호가 매겨진 목록은:
체계적이고
흐름을 따르기 쉽습니다.
2단계 번호 목록에 이어지는 내용
새로운 문자열은 그 목록이 끝났음을 나타냅니다.
다시 만들면 새 번호 1부터 시작합니다.
# 번호가 매겨진 목록과
#* 그렇지 않은 목록을
# 혼합하여
#*사용할 수 있습니다.
#*: 2단계 목록에 이어지는 내용
새로운 문자열은 그 목록이 끝났음을 나타냅니다.
* 물론 다시 시작할 수 있으며
*# 반대로 적용할 수도
*# 있습니다.
*#: 2단계 번호 목록에 이어지는 내용
번호가 매겨진 목록과
그렇지 않은 목록을
혼합하여
사용할 수 있습니다.
2단계 목록에 이어지는 내용
새로운 문자열은 그 목록이 끝났음을 나타냅니다.
물론 다시 시작할 수 있으며
반대로 적용할 수도
있습니다.
2단계 번호 목록에 이어지는 내용
poem 태그
아래의 예와 같이 빈 칸으로 시작되는 글은 점선으로 이뤄진 글상자에 적힌 글로 변환됩니다.
입력한 내용
결과
어떤 글이든 빈칸으로 시작되면 점선으로 둘러싸여 표시됩니다.
어떤 글이든 빈칸으로 시작되면 점선으로 둘러싸여 표시됩니다.
하지만 편집자는 종종 시, 가사, 좌우명, 선서 같은 것들을 표현할 때 글의 맨 앞에 빈칸을 두고도 다른 글들과 같이 표시되기를 바랍니다. 때로는 여러 개의 빈칸이 그대로 표시되기를 바라기도 합니다.〈poem〉태그는 태그 안에 적힌 텍스트를 적힌 그대로 표시해 줍니다. 이 태그는 <blockquote></blockquote> 같은 다른 태그 안에서 쓰일 수도 있습니다.
입력한 내용
결과
<poem>
죽는 날까지 하늘을 우러러
한점 부끄럼이 없기를
잎새에 이는 바람에도
나는 괴로워했다
별을 노래하는 마음으로
모든 죽어가는 것을 사랑해야지
그리고 나한테 주어진 길을
걸어가야겠다
오늘 밤에도 별이 바람에 스치운다
</poem>
죽는 날까지 하늘을 우러러
한점 부끄럼이 없기를
잎새에 이는 바람에도
나는 괴로워했다
별을 노래하는 마음으로
모든 죽어가는것을 사랑해야지
그리고 나에게 주어진 길을
걸어가야겠다
오늘 밤에도 별이 바람에 스치운다
형식
요약: 이 문단에서는 다음의 내용을 설명하고 있습니다.
글자의 모양
특수 문자의 사용
수식의 표현
글자 모양
결과
입력한 내용
2개의 작은따옴표를 양쪽에 입력하면 글자가
이탤릭체로 표시됩니다.
3개의 작은따옴표는 진한 글씨체.
5개의 작은따옴표는 진한이탤릭체의
글자 모양을 만듭니다.
하지만 한국어 위키백과에서는 이탤릭체의 사용을 가능하면 자제하도록 권고하고 있습니다.
2개의 작은따옴표를 양쪽에 입력하면 글자가
''이탤릭체''로 표시됩니다.
3개의 작은따옴표는 '''진한 글씨체'''.
5개의 작은따옴표는 '''진한''' ''이탤릭체''의
'''''글자 모양을 만듭니다.'''''
컴퓨터 코드는 배경색이 존재하며
좀 더 엄격한 형식을 취합니다.
예를 들어 <code>int main()</code>: 를 정의해보면:
<syntaxhighlight lang="cpp">#include <iostream>
int main ( int argc, char **argv ) {
std::cout << "Hello World!";
return 0;
}</syntaxhighlight>
문서에 조그마한 글씨로
설명문을 넣을 수 있습니다.
문서에 <small>조그마한 글씨로</small>
설명문을 넣을 수 있습니다.
큰 글씨는, 그것이 작은 글씨
사이에 놓이는 경우 외에는 사용을 자제해 주세요.
<big>큰 글씨는</big>, <small> 그것이 <big>작은 글씨</big>
사이에</small> 놓이는 경우 외에는 사용을 자제해 주세요.
빈칸이 아닌 칸(아무것도 안 보이는 글자)을 입력할 수도 있습니다. 예를 들어 영어와 같은 언어의 입력에서 두 단어가 항상 같은 줄에 보이도록 할 수 있는데, 아래 예시와 같이   를 두 "단어" 사이에 입력해 한 단어로 인식하도록(자동 줄 넘김으로 두 단어가 갈리지 않게) 합니다.
아래/위첨자를 문자 고유의 유니코드를 이용해 입력하는 방법의 경우 모든 문서에 쓰일 수는 없습니다. 이는 유니코드가 모든 사용자의 장비에서 지원되지는 않기 때문인데, 그럼에도 불구하고 1,2,3(한글 키보드에는 4까지) 윗첨자의 경우에는 입력 시간을 단축할 수 있기에 이 방법이 선호되기도 합니다. 3(한글 키보드에는 4)보다 큰 간단한 숫자를 첨자로 표현할 때에는 위키미디어의 특수문자 코드를 쓸 수도 있습니다.
간단한 수학 공식은 설명하는 글과 함께 섞어 사용할 수 있습니다. 아래의 예문을 보아주시기 바랍니다.
결과
가 실수일 때 가 항상 성립한다.
입력한 내용
<math> x </math>가 실수일 때 <math>x^2 \ge 0 </math> 가 항상 성립한다.
복잡한 공식
복잡한 공식 역시 〈math〉마크업을 사용하여 나타낼 수 있습니다.
결과
입력한 내용
: <math>\sum_{n=0}^\infty \frac{x^n}{n!}</math>
복잡한 공식은 그림으로 인식되기 때문에 문장 내에서 함께 사용할 경우 가독성이 떨어지게 됩니다. 따라서 문장의 다음 줄에 공식만을 따로 표기하는 방법을 권장합니다. 복잡한 수학 공식을 표기할 때에는 :(콜론)으로 시작하여야 실제 줄이 바뀝니다. 다음의 예를 보아 주시기 바랍니다.
결과
입력한 내용
권장하는 방식
따라서 다음과 같은 식으로 나타낼 수 있다.
이 식에 의한 급수는
따라서 다음과 같은 식으로 나타낼 수 있다.
<span class="mw-poem-indented" style="display: inline-block; margin-inline-start: 1em;"> <math>\sum_{n=0}^\infty \frac{x^n}{n!}</math></span>
이 식에 의한 급수는
O
따라서 다음과 같은 식으로 나타낼 수 있다. 이 식에 의한 급수는
따라서 다음과 같은 식으로 나타낼 수 있다. <math>\sum_{n=0}^\infty \frac{x^n}{n!}</math> 이 식에 의한 급수는
X
따라서 다음과 같은 식으로 나타낼 수 있다.
이 식에 의한 급수는
따라서 다음과 같은 식으로 나타낼 수 있다.
<math>\sum_{n=0}^\infty \frac{x^n}{n!}</math>
이 식에 의한 급수는
X
링크와 URL
자유 링크
미디어위키 소프트웨어의 마크업 언어를 이용하여, 여러분은 가리키고 싶은 문서의 제목 양쪽에 대괄호를 두 개씩 넣음으로써 자유롭게 링크를 만들게 됩니다. 예를 들어 [[서울]] 을 입력하면 서울 로 나타납니다. 원한다면 세로줄 (| : 파이프 문자)을 사용하여 링크의 제목을 변경할 수 있습니다. 예를 들어 [[서울특별시|대한민국의 수도]] 는, 링크가 대한민국의 수도 로 나타나며 "대한민국의 수도"라고 보이지만, 사실은 서울특별시로 연결됩니다.
다른 위키 문서로의 링크
내부적으로, 대/소문자가 있는 문자의 경우, 링크 대상 문서의 제목 첫 글자는 자동으로 대문자가 되며 빈 칸의 경우 밑줄로 변환됩니다.
그러므로 아래에 나와있는 링크는 ko.wikipedia.org/wiki/Mobile_IP 이라는 URL 을 가리키며, 이는 위키백과 내에서 "Mobile IP"라는 제목의 문서를 뜻합니다.
붉은 링크는 존재하지 않는 문서일 경우에 나타납니다. 링크를 따라가 그 이름을 가진 문서를 만들 수 있습니다.
링크 뒤에 단순히 파이프 문자(|)를 입력하는 것 만으로도 링크 제목을 일정한 형식으로 바꿀 수 있습니다. 편집 후 다음 번에 다시 편집 창을 열게 되면, 파이프 문자로 확장된 링크를 볼 수 있습니다. 하지만 여러분이 편집 내용을 저장하고 다시 편집하기 전 까지는, 예를 들어 편집 후 미리보기를 눌렀을 때에는 확장된 형식을 볼 수 없습니다. 이는 [[#현재 문서 내 문단을 링크하기|]] 에도 똑같이 적용됩니다.
우물 정자(#) 뒤에 따르는 부분은 해당 문서의 문단 머릿글과 일치해야 합니다. 철자 뿐 아니라 대소문자, 구두점까지 정확히 일치해야 제대로 기능합니다. 존재하지 않는 문단으로 링크가 될 경우 그 링크가 깨지지는 않고, 해당 문서의 맨 윗부분으로 연결됩니다.
"| 링크 제목"을 포함하면 원하는 링크 제목을 넣을 수 있습니다.
만일 같은 이름을 가진 문단이 여러 개일 경우, 그 이름을 가진 첫 번째 문단 이외의 문단으로 링크하려면 그 순서대로 숫자를 추가하면 됩니다. #머릿말 예제 3 은 "머릿말 예제"라는 이름을 가진 문단 중 세 번째 문단으로 이동시켜 줍니다. 역시 파이프 문자를 이용하여 # 기호를 보이지 않게 할 수 있습니다.
대괄호는 외부 링크를 가리킵니다. 링크에 "이름"을 붙일 때 그 URL과 이름을 하나의 빈 칸으로 구분합니다. 이 대괄호는 링크가 아닌 단순한 문구([이렇게])에도 쓰일 수 있습니다.
URL에 사용되는 모든 문자는, 다음의 범위 안에 속해야 합니다: A-Z a-z 0-9 . _ \ / ~ % - + & # ? ! = ( ) @
만일 위에 속하지 않은 문자가 URL에 포함되어 있다면, 그것은 퍼센트 문자(%)에 따르는 hex 코드로 변경되어야 하며 간단한 기호들은 출력 가능한 ASCII 문자표를 참고하세요. 예를 들어 캐럿 문자(^)는 URL에서 %5E로 변환되며, 대괄호는 %5B 와 %5D 로 변환됩니다. 단, 한글의 경우에는 확장 유닉스 코드를 따르므로, 별도의 변환 방법(예: 한글이 포함된 주소를 복사하여 인터넷 익스플로러 주소창에 붙여넣으면 주소가 자동으로 EUC-KR로 변환됩니다.)을 찾는 것이 좋습니다.
만일, 제목이 있는 외부 링크의 경우 그 제목에 대괄호 "]"가 포함된다면, 꼭 직접 입력하지 마시고 HTML 특수문자 구문인 ]을 사용하세요. 그렇지 않으면 미디어위키 소프트웨어가 제목에 쓰인 대괄호를 외부 링크의 끝으로 인식할 것입니다.
단행본의 경우 고유의 ISBN을 사용하여 링크를 걸 수 있습니다. 이는 사용자에게 판매자를 고를 권리를 준다는 점에서 특정 온라인 서점을 링크하는 것보다 권장됩니다. 하지만, 일부 온라인 서점에서 목차나 본문 일부 등, 더 많은 무료 정보를 제공한다면 해당 온라인 서점으로의 링크가 권장됩니다. ISBN 링크는 아래 제시된 사용법 이외에 어떠한 마크업도 필요하지 않습니다.
도서 자료로의 링크를 만들 때 ISBN 이외의 특정 명칭(예를 들어 책 제목)을 사용하고 싶다면, 위키 내부 링크 형식을 따라 알맞은 이름공간을 입력하여 사용합니다.
틀은 위키 마크업으로 이뤄진 한 부분으로, 문서 중간에 복사될(끼워넣어질) 목적으로 만들어집니다. 틀을 끼워넣기 위해서는 틀의 이름을 {{중괄호 안에}} 넣으면 되고, 다른 문서를 현재 문서 안에 끼워넣으려면 문서의 이름을 {{:콜론이 있는 중괄호 안에}} 입력하면 됩니다.
틀이나 문서의 어느 부분을 끼워넣을지 정하는 기능을 가진 세 쌍의 태그가 있습니다. 이것들은 해당 문서 자신(이하 "이곳")이나, 문서의 내용을 끼워넣을 다른 문서(이하 "저곳")에서 위키텍스트를 계산하고 표시할 지 말 지를 결정합니다.
<noinclude>: 이 내용은 "저곳"에서 보이지 않게 됩니다. "이곳"에서는 아무런 영향이 없습니다.
<includeonly>: 이 내용은 "저곳"에서만 표시되고, "이곳"에서는 보이지 않게 됩니다.
<onlyinclude>: 이 내용은 "이곳"과 "저곳" 모두에서 표시됩니다. 하지만 "저곳"에서는 이 태그 사이에 있는 내용만이 나타납니다.
보충설명
위키백과:TeX 문법 문서를 참고하십시오.
