2017년 1월 30일 (월) 12:39에 Maintenance script님의 편집

2017-01-30T12:39:46Z

새 문서

[[http://daringfireball.net/projects/markdown/|공식 사이트]]

[목차]
== 개요 ==
마크다운 (Markdown)은 [[마크업 언어]]의 일종으로, 존 그루버(John Gruber)와 아론 스워츠(Aaron Swartz)가 만들었다. 읽기도 쓰기도 쉽다는 장점이 있다. 그루버는 마크다운으로 작성한 문서를 [[HTML]]로 변환하는 [[Perl|펄]] 스크립트도 만들었다. [[확장자]]는 .md를 쓴다.

== 문법 ==
여기서 언급하는 '위키문법'은 [[나무위키:편집 도움말|나무마크]]가 기준입니다.

=== 문단 제목 ===
위키 문법의 {{{== 개요 ==}}}에 대응하는 문법이다.

{{{
# 1단계 제목
## 2단계 제목
}}}
또는 다음과 같이 쓸 수도 있다.

{{{
First-level heading
===================
}}}

=== 문단 ===
줄바꿈을 두 번 하면 된다.

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

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

=== 목록 ===
위키 문법과 같으나 첫번째 칸을 띄어쓰지 않아도 된다.

{{{
* 목록 하나
* 목록 두울
* 목록 세엣
- 이렇게 써도
- 된답니다.
}}}
순서가 있는 목록은 다음과 같이 쓴다. 이 때, 숫자는 반드시 맞춰 쓸 필요는 없다.

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

=== 글자모양 ===
굵은 글자는 다음과 같이 쓴다. 위키 문법 {{{'''굵게'''}}}에 대응하는 문법이다.

{{{
**굵게** 쓰거나 __두껍게__ 쓰거나
}}}
결과: '''굵게''' 쓰거나 '''두껍게''' 쓰거나

기울임꼴 글자는 다음과 같이 쓴다. 위키 문법 {{{''기울게''}}}에 대응하는 문법이다.

{{{
*기울게* 쓰면서 _기울게_ 쓴다
}}}
결과: ''기울게'' 쓰면서 ''기울게'' 쓴다

취소선 기능은 다음과 같이 쓴다. 위키 문법 {{{"취소선"}}}에 대응하는 문법이다.

{{{
~~취소~~ 한다
}}}
결과: --취소-- 한다
=== 코드 ===
(특히 [[프로그래밍]] 관련 문서에서) 코드를 입력할 필요가 있을 땐 다음과 같이 쓴다. [[글꼴#s-2.1.2|고정폭 글꼴]]로 출력되며 위키 문법 {{{{{{ code }}}}}}에 대응하는 문법이다.

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

{{{
`import antigravity`
}}}[* [[Python|파이썬]]의 [[이스터 에그]] 중 하나. [[웹 브라우저]]로 [[xkcd]]의 만화 [[http://xkcd.com/353/|PYTHON]]을 띄운다.]
여러 줄의 코드는 다음과 같이 줄 첫부분을 공백 4칸이상 띄어서 쓴다.

{{{
#!/usr/bin/env clojure
(println "Hello, World!")
}}}

=== 강제 개행 ===
그냥 줄바꿈을 하면 하나의 문장으로 인식한다. 만약 [[강제개행]]을 하려면 줄 끝에 공백 두칸을 넣으면 된다. (눈에 안보이므로 드래그를 해보세요)

{{{
강제
개행
}}}

=== 인용문 ===
줄 첫번째마다 >를 쓰면 된다. 위키 문법에도 동일하게 쓴다.

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

=== 링크 ===
[[링크]]는 다음과 같이 쓴다. 위키 문법의 {{{[[https://namu.wiki/|나무위키]]}}}에 대응하는 문법이다.

{{{
[나무위키](https://namu.wiki/w/나무위키:대문)
}}}
또는 다음과 같이 써서 주석형태로 링크를 쓸 수 있다.

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

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

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

{{{
![세피로트](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속성에 해당한다.

=== 가로줄 ===
가로줄을 넣는 문법은 여러가지가 있다. 위키 문법의 {{{ ---- }}}에 대응하는 문법이다.

{{{
* * *
***
*****
- - -
------------
}}}

== 마크다운을 사용하는 곳 ==
* [[텀블러#s-3|텀블러]]
* [[reddit|레딧]]
* [[GitHub]] [* 마크다운을 변형한 Github-Flavored Markdown을 쓴다.]
* [[Stack Overflow]]
* [[도쿠위키]] : [[https://www.dokuwiki.org/plugin:markdowku|플러그인]]을 사용하여 마크다운 문법을 사용할 수 있다.
* [[모니위키]] : 버전 1.1.3부터 마크다운 프로세서 플러그인을 기본 내장하고 있다.
* [[Trello]]
== 마크다운 변형판 ==
=== Github-Flavored Markdown ===
[[http://github.github.com/github-flavored-markdown/|Github-Flavored Markdown]]
[[github]]에서 쓰이며 다음과 같은 차이점이 있다.
* 줄바꿈을 한번만 해도 강제개행을 할 수 있다.
* do_this_and_do_that과 같은 형태의 단어를 기울임꼴 글자로 처리하지 않는다.
* URL을 자동으로 링크로 변환해준다.
* 코드를 입력할 때 {{{```}}} 로 감싸주는 문법이 추가되었다.
* 문법 강조가 적용이 된다. [[https://github.com/github/linguist|Linguist]]를 이용하여 처리한다.
* 작업 목록(Task lists) 문법이 추가되었다.
* [[Git]]관련 링크를 자동으로 처리해준다. (SHA, 사용자, 이슈 등)

=== MultiMarkdown ===
[[http://fletcherpenney.net/multimarkdown/|MultiMarkdown]]
기존 마크다운에 없는 기능(주석, 표 등)이 추가되어있다.

=== Haroopad Flavored Markdown ===
하루패드에서 쓰이며 다음과 같은 차이점이 있다.
* 강조 문법이 추가되었다. 사용 방법은 {{{== 강조 ==}}} 처럼 쓰면 된다. --어디서 본 것 같은데--
* 목차 기능이 추가되었다. 사용 방법은 {{{[TOC]}}}처럼 쓰면 된다.
* {{{ @[](http://www.youtube.com/watch?v=jo_B4LTHi3I) }}} 처럼 유튜브 영상 등을 추가할 수 있다.
* 다이어그램 기능이 추가되었다.
== 관련 문서 ==
* [[HTML]]

[[분류:마크업 언어]]

마크다운 - 편집 역사

2017년 1월 30일 (월) 12:39에 Maintenance script님의 편집