마크다운(MarkDown)

1. 개요

마크다운 (Markdown)은 마크업 언어 의 일종으로, 존 그루버(John Gruber)와 아론 스워츠(Aaron Swartz)가 만들었다. 온갖 태그로 범벅된 HTML 문서 등과 달리, 읽기도 쓰기도 쉬운 문서 양식을 지향한다. 그루버는 마크다운으로 작성한 문서를 HTML로 변환하는 Perl 스크립트도 만들었다. 흔히 볼 수 있는 문서(파일명)은 ‘README.md’, 파일의 확장자는 .md 또는 .markdown을 쓴다.

2. 문법

2.1. 문단 제목

# 1단계 제목
## 2단계 제목

또는 다음과 같이 쓸 수도 있다.

1단계 제목
=======
2단계 제목
------

2.2. 문단

줄 바꿈을 두 번 하면 된다.

첫째 문단입니다. 문장이 두 개죠.

둘째 문단입니다. 저도
문장이 두 개입니다.

마크다운은 기본적으로 강제 개행을 인식하지 않기 때문에, 두 번째 예시를 HTML 등으로 변환할 경우 줄 바꿈이 없는 ‘둘째 문단입니다. 저도 문장이 두 개입니다.‘로 변환된다. 강제 개행을 인식하게 하려면 줄 끝에 공백을 두 칸 넣거나(가독성 문제로 권장되지 않음), 아니면 줄 끝에 역슬래시()를 넣어도 된다.

2.3. 목록

첫 번째 칸을 띄어 쓰지 않아도 된다.

* 목록 하나
* 목록 두울
* 목록 세엣
- 이렇게 써도
- 된답니다.

순서가 있는 목록은 다음과 같이 쓴다. 숫자는 반드시 맞춰 쓸 필요는 없다. 어차피 마크다운 기본 문법에서는 각 행이 HTML의 <li> 태그로 변환되는 것일 뿐이라 번호 정보가 사라지기 때문.

1. 첫째입니다.
2. 둘째입니다.
3. 셋째입니다.
5. 넷째입니다. 다섯째 아닙니다.
6. 이게 다섯째입니다.
4. 이건 여섯째.

2.4. 글자 모양

굵은 글자는 다음과 같이 쓴다.

**굵게** 쓰거나 __두껍게__ 쓰거나

결과: 굵게 쓰거나 두껍게 쓰거나

기울임 꼴 글자는 다음과 같이 쓴다.

*기울게* 쓰면서 _기울게_ 쓴다

결과: 기울게 쓰면서 기울게 쓴다

2.5. 코드

코드를 입력할 필요가 있을 땐 다음과 같이 쓴다.

문장 중간에 표시할 땐 다음과 같이 쓴다.

예를 들어 `import antigravity` 이렇게요.

여러 줄의 코드는 다음과 같이 줄 첫 부분을 공백 4칸 이상 띄어서 쓴다.

다음은 Clojure의 예시 코드다.
clojure
    #!/usr/bin/env clojure
    (println "Hello, World!")

2.6. 인용문

줄 첫 번째마다 >를 쓰면 된다.

>> 빛이 있으라.
> 하니 빛이 있었다.

결과:

빛이 있으라.

하니 빛이 있었다.

2.7. 링크

링크는 다음과 같이 쓴다.

[나무위키](https://namu.wiki/w/나무위키:대문)

또는 다음과 같이 써서 주석 형태로 링크를 쓸 수 있다.

출처는 [위키백과][wiki]입니다.

[wiki]: http://en.wikipedia.org/wiki/Markdown#Syntax_examples "위키백과 Markdown 항목"

2.8. 그림 넣기

그림을 넣을 땐 다음과 같이 쓴다.

![세피로트](https://cdn.namu.wiki/r/http%3A%2F%2Fi.imgur.com%2F2megHz2.png "툴팁 메시지. 이 부분은 생략해도 됩니다.")

또는 다음과 같이 써서 주석 형태로 그림을 넣을 수 있다.

![세피로트][SD]

[SD]: https://cdn.namu.wiki/r/http%3A%2F%2Fi.imgur.com%2F2megHz2.png "툴팁 메시지. 이 부분은 생략해도 됩니다."

“세피로트” 부분은 HTML img 태그의 alt 속성에, “툴팁 메시지” 부분은 title 속성에 해당한다.

2.9. 가로줄

가로줄을 넣는 문법은 여러 가지가 있다.

* * *
***
*****
- - -
------------