Learn markdown in Y Minutes

마크다운은 2004년에 존 그루버가 창시했습니다. HTML으로 (그리고 이제는 다른 다양한 형식으로도) 쉽게 변환되는 읽고 쓰기 쉬운 문법입니다.

마크다운은 또한 파서마다 구현이 다양합니다. 본 문서는 어떤 기능이 보편적인지, 혹은 어떤 기능이 특정 파서에 종속되어 있는지 명확히 하고자 합니다.

HTML 요소
제목
간단한 텍스트 꾸미기
문단
목록
코드
수평선
링크
이미지
기타

HTML 요소

HTML은 마크다운의 수퍼셋입니다. 모든 HTML 파일은 유효한 마크다운이라는 것입니다.

<!--따라서 주석과 같은 HTML 요소들을 마크다운에 사용할 수 있으며, 마크다운 파서에 영향을
받지 않을 것입니다. 하지만 마크다운 파일에서 HTML 요소를 만든다면 그 요소의 안에서는
마크다운 문법을 사용할 수 없습니다.-->

제목

텍스트 앞에 붙이는 우물 정 기호(#)의 갯수에 따라 <h1>부터 <h6>까지의 HTML 요소를 손쉽게 작성할 수 있습니다.

# <h1>입니다.
## <h2>입니다.
### <h3>입니다.
#### <h4>입니다.
##### <h5>입니다.
###### <h6>입니다.

또한 h1과 h2를 나타내는 다른 방법이 있습니다.

h1입니다.
=============

h2입니다.
-------------

간단한 텍스트 꾸미기

마크다운으로 쉽게 텍스트를 기울이거나 굵게 할 수 있습니다.

*기울인 텍스트입니다.*
_이 텍스트도 같습니다._

**굵은 텍스트입니다.**
__이 텍스트도 같습니다.__

***기울인 굵은 텍스트입니다.***
**_이 텍스트도 같습니다._**
*__이것도 같습니다.__*

깃헙 전용 마크다운에는 취소선도 있습니다.

~~이 텍스트에는 취소선이 그려집니다.~~

문단

문단은 하나 이상의 빈 줄로 구분되는, 한 줄 이상의 인접한 텍스트입니다.

문단입니다. 문단에 글을 쓰다니 재밌지 않나요?

이제 두 번째 문단입니다.
아직도 두 번째 문단입니다.

나는 세 번째 문단!

HTML <br /> 태그를 삽입하고 싶으시다면, 두 개 이상의 띄어쓰기로 문단을 끝내고 새 문단을 시작할 수 있습니다.

띄어쓰기 두 개로 끝나는 문단 (마우스로 긁어 보세요).  

이 위에는 `<br />` 태그가 있습니다.

인용문은 > 문자로 쉽게 쓸 수 있습니다.

> 인용문입니다. 수동으로 개행하고서
> 줄마다 `>`를 칠 수도 있고 줄을 길게 쓴 다음에 저절로 개행되게 내버려 둘 수도 있습니다.
> `>`로 시작하기만 한다면 차이가 없습니다.

> 한 단계 이상의 들여쓰기를
>> 사용할 수도 있습니다.
> 깔끔하죠?

순서가 없는 목록은 별표, 더하기, 하이픈을 이용해 만들 수 있습니다.

* 이거
* 저거
* 그거

또는

+ 이거
+ 저거
+ 그거

또는

- 이거
- 저거
- 그거

순서가 있는 목록은 숫자와 마침표입니다.

1. 하나
2. 둘
3. 셋

숫자를 정확히 붙이지 않더라도 제대로 된 순서로 보여주겠지만, 좋은 생각은 아닙니다.

1. 하나
1. 둘
1. 셋

(위의 예시와 똑같이 나타납니다.)

목록 안에 목록이 올 수도 있습니다.

1. 하나
2. 둘
3. 셋
    * 이거
    * 저거
4. 넷

심지어 할 일 목록도 있습니다. HTML 체크박스가 만들어집니다.

x가 없는 박스들은 체크되지 않은 HTML 체크박스입니다.
- [ ] 첫 번째 할 일
- [ ] 두 번째 할 일
이 체크박스는 체크된 HTML 체크박스입니다.
- [x] 완료된 일

코드

띄어쓰기 네 개 혹은 탭 한 개로 줄을 들여씀으로서 (<code> 요소를 사용하여) 코드를 나타낼 수 있습니다.

    puts "Hello, world!"

탭을 더 치거나 띄어쓰기를 네 번 더 함으로써 코드를 들여쓸 수 있습니다.

    my_array.each do |item|
      puts item
    end

인라인 코드는 백틱 문자를 이용하여 나타냅니다. `

철수는 `go_to()` 함수가 뭘 했는지도 몰랐어!

깃헙 전용 마크다운에서는 코드를 나타내기 위해 특별한 문법을 쓸 수 있습니다.

```ruby
def foobar
  puts "Hello world!"
end
```

위의 경우에 들여쓰기가 필요없을 뿐 아니라 “` 뒤에 특정해 준 언어의 문법에 따라 색을 입혀줄 것입니다.

수평선

수평선(<hr/>)은 셋 이상의 별표나 하이픈을 이용해 쉽게 나타낼 수 있습니다. 띄어쓰기가 포함될 수 있습니다.

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

링크

마크다운의 장점 중 하나는 링크를 만들기 쉽다는 것입니다. 대괄호 안에 나타낼 텍스트를 쓰고 괄호 안에 URL을 쓰면 됩니다.

[클릭](http://test.com/)

괄호 안에 따옴표를 이용해 링크에 제목을 달 수도 있습니다.

[클릭](http://test.com/ "test.com으로 가기")

상대 경로도 유효합니다.

[music으로 가기](/music/).

참조하는 식으로 링크를 걸 수도 있습니다.

[이 ][링크]에서 더 알아보세요!
[원하신다면 ][foobar]도 참고하세요.

[링크]: http://test.com/ "좋아!"
[foobar]: http://foobar.biz/ "됐다!"

제목은 작은 따옴표나 괄호에 들어갈 수도 있고, 완전히 생략할 수도 있습니다. 참조는 문서의 어느 곳에든 올 수 있고 참조 ID는 유일하다면 무엇이든 될 수 있습니다.

링크 텍스트를 ID로 사용하는 "묵시적 이름"도 있습니다.

[이것][]은 링크입니다.

[이것]: http://thisisalink.com/

하지만 보통 그렇게 추천하지는 않습니다.

이미지

이미지는 링크와 같지만 앞에 느낌표가 붙습니다.

![이미지의 alt 속성](http://imgur.com/myimage.jpg "제목")

참조 방식도 가능합니다.

![alt 속성][이미지]

[이미지]: relative/urls/cool/image.jpg "제목이 필요하다면 여기에"

기타

자동 링크

<http://testwebsite.com/>와
[http://testwebsite.com/](http://testwebsite.com/)는 동일합니다.

이메일 자동 링크

<[email protected]>

탈출 문자

*별표 사이에 이 텍스트*를 치고 싶지만 기울이고 싶지는 않다면
이렇게 하시면 됩니다. \*별표 사이에 이 텍스트\*.

키보드 키

깃헙 전용 마크다운에서는 <kbd> 태그를 이용해 키보드 키를 나타낼 수 있습니다.

컴퓨터가 멈췄다면 눌러보세요.
<kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>Del</kbd>

표

표는 깃헙 전용 마크다운에서만 쓸 수 있고 다소 복잡하지만, 정말 쓰고 싶으시다면

| 1열      | 2열        | 3열       |
| :--------| :-------: | --------: |
| 왼쪽 정렬 | 가운데 정렬 | 오른쪽 정렬 |
| 머시기    | 머시기     | 머시기     |

혹은

1열 | 2열 | 3열
:-- | :-: | --:
으악 너무 못생겼어 | 그만 | 둬

추가 정보를 위해, 존 그루버의 공식 문법 (영어) 문서와 애덤 프릿차드의 훌륭한 (영어) 치트싯을 확인하세요.

제안이 있으세요? 아니면 실수를 찾으셨어요? GitHub에서 issue 또는 pull request를 만드세요

원작자는 Dan Turkel, 그리고 4 기여자들 수정했다

Y분에 X를 배우다

여기서 X=markdown