[Markdown] 마크다운 사용법 총정리

Markdown은 간단한 문법을 사용해서 일반 텍스트의 서식을 지정할 수 있는 lightweight markup 언어이다.

일반적으로 문서 작성, 블로그 게시물 작성 및 온라인 플랫폼용 텍스트 서식 지정에 사용된다.

이제 마크다운 사용법을 알아보자.

참고로 본 게시물도 마크다운으로 작성해보았다.

---

Header 헤더

마크다운의 헤더는 해시 기호(#)을 사용하여 만들 수 있다.

해시 기호의 수는 해더의 수준을 나타내며 한 개가 가장 크고 여섯 개가 가장 작다.

예를 들어

# h1 Heading
## h2 Heading
### h3 Heading
#### h4 Heading
##### h5 Heading
###### h6 Heading

을 입력하면,

h1 Heading

h2 Heading

h3 Heading

h4 Heading

h5 Heading

h6 Heading

와 같이 나온다.

또 다른 방법은 setext 스타일 제목을 사용할 수도 있다.

해시 기호 한 개#와 같은 수준 1의 제목의 경우 등호=, 해시 기호 두 개##와 같은 수준 2의 부제목의 경우 하이픈-으로 텍스트에 밑줄을 긋는 방식으로 생성할 수 있다.

예를 들어

Heading 1
=========

Heading 2
---------

을 입력하면,

Heading 1

Heading 2

와 같이 나온다.

---

Line Break 줄바꿈

줄바꿈은 엔터를 두 번 치면 된다.

마크다운은 강제개행을 인식하지 않기 때문에 엔터를 한 번 치면 줄바꿈이 되지 않는다.

예를 들어

"첫 번째 문단.
줄을 바꿔봅시다.
\
두 번째 문단.

줄을 바꿔봅시다."

을 입력하면,

"첫 번째 문단. 줄을 바꿔봅시다.

두 번째 문단.

줄을 바꿔봅시다."

처럼 나온다.

빈 줄을 만들고 싶으면 비우고 싶은 줄에 역슬래쉬\를 쳐도 된다.

---

Bold, Italic and Strikethrough 볼드체, 이탤릭체, 취소선

텍스트를 굵게 표시하려면 이중 별표 **text**또는 이중 밑줄 __text__로 둘러싸면 된다.

텍스트를 기울여서 표시하려면 단일 별표 *text*또는 단일 밑줄 _text_로 둘러싸면 된다.

텍스트에 취소선을 그으려면 이중 물결 ~~text~~로 둘러싸면 된다.

예를 들어

**이중 별표**, __이중 밑줄__
*단일 별표*, _단일 밑줄_
~~취소선~~

을 입력하면,

이중 별표, 이중 밑줄
단일 별표, 단일 밑줄

취소선

와 같이 나온다.

---

Links 링크

텍스트를 대괄호[] 안에 넣고 URL이나 링크를 괄호()안에 넣어 링크를 만들 수 있다.

예를 들어

[파이토치로 ACGAN 구현하기](https://dykm.tistory.com/45)

을 입력하면,

파이토치로 ACGAN 구현하기

와 같이 나온다.

---

Images 이미지

이미지를 삽입하려면 느낌표! 다음에 대체 텍스트가 포함된 대괄호[]와 이미지 URL이 포함된 괄호()를 사용한다.

예를 들어

![imgur](https://i.imgur.com/9cgQVqD.png)

을 입력하면,

와 같이 나온다.

---

Lists 목록

마크다운은 글머리 기호를 사용하는 목록과 번호를 매기는 목록을 지원한다.

Unordered 글머리 기호 사용

하이픈-을 사용하여 목록을 만들 수 있는데 설명보다 직접 코드를 통해 살펴보자.

아래와 같이 입력하면

- 먼저 그냥 하이픈을 사용하고 띄어쓰기를 한 다음 글을 쓰면 된다.
+ 하이픈 대신 더하기 기호`+`나, 별표`*`를 사용해도 된다.
* 다음 수준의 목록은 앞에 두 번 띄어쓰기를 하고 목록을 만들면 된다.
  - 두 번의 띄어쓰기 대신 탭키`Tab`을 쳐도 된다.
    - 더 들어갈 수 있다.
      - 계속 들어갈 수 있다.
        - 아
          - 아
- 진짜 쉽다!

이렇게 나온다.

• 먼저 그냥 하이픈을 사용하고 띄어쓰기를 한 다음 글을 쓰면 된다.
• 하이픈 대신 더하기 기호+나, 별표*를 사용해도 된다.
• 다음 수준의 목록은 앞에 두 번 띄어쓰기를 하고 목록을 만들면 된다.
  • 두 번의 띄어쓰기 대신 탭키Tab을 쳐도 된다.
    • 더 들어갈 수 있다.
      • 계속 들어갈 수 있다.
        • 아
          • 아
• 진짜 쉽다!

Ordered 번호 매기기

그냥 번호를 앞에 쓰고 점을 찍어준 후 띄어쓰기를 하고 목록을 적으면 된다.

아래 글을 통해 살펴보자.

1. 번호와 점을 찍고 띄어쓰기를 하면 된다.
2. Lorem ipsum dolor sit amet
3. Consectetur adipiscing elit
4. Integer molestie lorem at massa
5. 위 글이 뭔지 궁금하면 구글링해보자.

1. 숫자를 헷갈려 앞에 1을 써도
1. 아니면 계속 1을 써도
2. 다시 목록을 시작해도
3. 숫자는 그냥 계속 나온다

시작하는 숫자를 지정할 수 있다:

57.  text
1.  text

위를 입력하면 아래와 같이 나온다.

1. 번호와 점을 찍고 띄어쓰기를 하면 된다.
2. Lorem ipsum dolor sit amet
3. Consectetur adipiscing elit
4. Integer molestie lorem at massa
5. 위 글이 뭔지 궁금하면 구글링해보자.
6. 숫자를 헷갈려 앞에 1을 써도
7. 아니면 계속 1을 써도
8. 다시 목록을 시작해도
9. 숫자는 그냥 계속 나온다

시작하는 숫자를 지정할 수 있다:

57. text
58. text

---

Blockquotes 인용구

인용구는 마치 목록을 만들 때처럼 >기호를 쓰고 한 칸을 띄운 다음 인용할 문구를 적으면 된다.

예를 들어

> 보통은 `>`개수로 인용 수준을 나타내는데
티스토리는 안된다.
되면 좋겠다.

을 입력하면,

보통은 >개수로 인용 수준을 나타내는데
티스토리는 안된다.
되면 좋겠다.

이렇게 나온다.

>기호의 개수로 인용 정도를 조절할 수 있다.

티스토리는 지원하지 않는 기능으로 인용 개수를 조절하는 예시만 보여주겠다.

> 인용
> > 인용의 인용

이렇게 쓰면 된다.

---

Horizontal Rules 수평선 긋기

내용을 구분할 때 종종 수평선을 긋는다.

수평선은 ---, ***, ===으로 그을 수 있다.

예를 들어

---
***
___

을 입력하면,

---

---

---

와 같이 나온다.

---

Tables 표

마크다운으로 간단한 표를 만들 수 있다.

바 기호|를 사용해서 만들고 첫 줄 밑에는 ---을 쳐줘야한다.

---에서 -개수는 그냥 충분히 쳐주자.

직접 예시를 통해 살펴보자.

아래와 같이 입력하면,

| Option | Description |
| --- | --- |
| data | path to data files to supply the data that will be passed into templates. |
| engine | engine to be used for processing templates. Handlebars is the default. |
| ext | extension to be used for dest files. |

오른쪽으로 정렬하려면 `---`뒤에 `:`을 붙이자.

| Option | Description |
| --: | --: |
| data | path to data files to supply the data that will be passed into templates. |
| engine | engine to be used for processing templates. Handlebars is the default. |
| ext | extension to be used for dest files. |

왼쪽으로 정렬하려면 `:`을 먼저 쓰고 `---`을 붙이자.

| Option | Description |
| :-- | :-- |
| data | path to data files to supply the data that will be passed into templates. |
| engine | engine to be used for processing templates. Handlebars is the default. |
| ext | extension to be used for dest files. |

가운데 정렬하려면 `---`을 `:`으로 감싸주자.

| Option | Description |
| :-: | :-: |
| data | path to data files to supply the data that will be passed into templates. |
| engine | engine to be used for processing templates. Handlebars is the default. |
| ext | extension to be used for dest files. |

Option	Description
data	path to data files to supply the data that will be passed into templates.
engine	engine to be used for processing templates. Handlebars is the default.
ext	extension to be used for dest files.

오른쪽으로 정렬하려면 ---뒤에 :을 붙이자.

Option	Description
data	path to data files to supply the data that will be passed into templates.
engine	engine to be used for processing templates. Handlebars is the default.
ext	extension to be used for dest files.

왼쪽으로 정렬하려면 :을 먼저 쓰고 ---을 붙이자.

Option	Description
data	path to data files to supply the data that will be passed into templates.
engine	engine to be used for processing templates. Handlebars is the default.
ext	extension to be used for dest files.

가운데 정렬하려면 ---을 :으로 감싸주자.

Option	Description
data	path to data files to supply the data that will be passed into templates.
engine	engine to be used for processing templates. Handlebars is the default.
ext	extension to be used for dest files.

이렇게 나온다.

선이 없어서 뭔가 싶지만 잘 보면 표다.

아직 티스토리는 표에 선을 그려주지를 않는다.

---

ToDo List 체크박스

아래와 같이 입력해보자.

- [ ] ToDos
    - [x] Buy some salad
    - [ ] Brush teeth
    - [x] Drink some water

그러면 아래와 같이 나온다.

• ToDos
  • Buy some salad
  • Brush teeth
  • Drink some water

MathJax 수식 입력

티스토리에서는 지원하지 않는 기능인데 수식을 입력할 수도 있다.

$$
x = {-b \pm \sqrt{b^2-4ac} \over 2a}.
$$

$$
\Gamma(z) = \int_0^\infty t^{z-1}e^{-t}dt\,.
$$

위와 같이 입력하면 수식이 튀어나오는데 수식에 대한 문법은 여기를 참고하자.

---

내가 작성한 본문은 이렇다.

Markdown은 간단한 문법을 사용해서 일반 텍스트의 서식을 지정할 수 있는 lightweight markup 언어이다.

일반적으로 문서 작성, 블로그 게시물 작성 및 온라인 플랫폼용 텍스트 서식 지정에 사용된다.

이제 마크다운 사용법을 알아보자.

참고로 본 게시물도 마크다운으로 작성해보았다.

---

# Header 헤더

마크다운의 헤더는 해시 기호(#)을 사용하여 만들 수 있다.

해시 기호의 수는 해더의 수준을 나타내며 한 개가 가장 크고 여섯 개가 가장 작다.  

예를 들어

```
# h1 Heading
## h2 Heading
### h3 Heading
#### h4 Heading
##### h5 Heading
###### h6 Heading
```

을 입력하면,

# h1 Heading

## h2 Heading

### h3 Heading

#### h4 Heading

##### h5 Heading

###### h6 Heading

와 같이 나온다.
\
또 다른 방법은 setext 스타일 제목을 사용할 수도 있다.

해시 기호 한 개`#`와 같은 수준 1의 제목의 경우 등호`=`, 해시 기호 두 개`##`와 같은 수준 2의 부제목의 경우 하이픈`-`으로 텍스트에 밑줄을 긋는 방식으로 생성할 수 있다.
\
예를 들어

```
Heading 1
=========

Heading 2
---------
```

을 입력하면,

# Heading 1

## Heading 2

와 같이 나온다.

---

# Line Break 줄바꿈

줄바꿈은 엔터를 두 번 치면 된다.

마크다운은 강제개행을 인식하지 않기 때문에 엔터를 한 번 치면 줄바꿈이 되지 않는다.
\
예를 들어

```
"첫 번째 문단.
줄을 바꿔봅시다.
\
두 번째 문단.

줄을 바꿔봅시다."
```

을 입력하면,

"첫 번째 문단.  
줄을 바꿔봅시다.
\
두 번째 문단.

줄을 바꿔봅시다."

처럼 나온다.
\
빈 줄을 만들고 싶으면 비우고 싶은 줄에 역슬래쉬`\`를 쳐도 된다.

---

# Bold, Italic and Strikethrough 볼드체, 이탤릭체, 취소선

텍스트를 굵게 표시하려면 이중 별표 `**text**`또는 이중 밑줄 `__text__`로 둘러싸면 된다.

텍스트를 기울여서 표시하려면 단일 별표 `*text*`또는 단일 밑줄 `_text_`로 둘러싸면 된다.

텍스트에 취소선을 그으려면 이중 물결 `~~text~~`로 둘러싸면 된다.
\
예를 들어

```
**이중 별표**, __이중 밑줄__
*단일 별표*, _단일 밑줄_
~~취소선~~
```

을 입력하면,

**이중 별표**, **이중 밑줄**  
_단일 별표_, _단일 밑줄_

~취소선~

와 같이 나온다.

---

# Links 링크

텍스트를 대괄호\[\] 안에 넣고 URL이나 링크를 괄호()안에 넣어 링크를 만들 수 있다.
\
예를 들어

```
[파이토치로 ACGAN 구현하기](https://dykm.tistory.com/45)
```

을 입력하면,

[파이토치로 ACGAN 구현하기](https://dykm.tistory.com/45)

와 같이 나온다.

---

# Images 이미지

이미지를 삽입하려면 느낌표`!` 다음에 대체 텍스트가 포함된 대괄호\[\]와 이미지 URL이 포함된 괄호()를 사용한다.
\
예를 들어

```
![imgur](https://i.imgur.com/9cgQVqD.png)
```

을 입력하면,

![imgur](https://i.imgur.com/9cgQVqD.png)

와 같이 나온다.

---

# Lists 목록

마크다운은 글머리 기호를 사용하는 목록과 번호를 매기는 목록을 지원한다.

### Unordered 글머리 기호 사용

하이픈`-`을 사용하여 목록을 만들 수 있는데 설명보다 직접 코드를 통해 살펴보자.
\
아래와 같이 입력하면

```
- 먼저 그냥 하이픈을 사용하고 띄어쓰기를 한 다음 글을 쓰면 된다.
+ 하이픈 대신 더하기 기호`+`나, 별표`*`를 사용해도 된다.
* 다음 수준의 목록은 앞에 두 번 띄어쓰기를 하고 목록을 만들면 된다.
  - 두 번의 띄어쓰기 대신 탭키`Tab`을 쳐도 된다.
    - 더 들어갈 수 있다.
      - 계속 들어갈 수 있다.
        - 아
          - 아
- 진짜 쉽다!
```

이렇게 나온다.

-   먼저 그냥 하이픈을 사용하고 띄어쓰기를 한 다음 글을 쓰면 된다.
-   하이픈 대신 더하기 기호`+`나, 별표`*`를 사용해도 된다.
-   다음 수준의 목록은 앞에 두 번 띄어쓰기를 하고 목록을 만들면 된다.
    -   두 번의 띄어쓰기 대신 탭키`Tab`을 쳐도 된다.
        -   더 들어갈 수 있다.
            -   계속 들어갈 수 있다.
                -   아
                    -   아
-   진짜 쉽다!

### Ordered 번호 매기기

그냥 번호를 앞에 쓰고 점을 찍어준 후 띄어쓰기를 하고 목록을 적으면 된다.
\
아래 글을 통해 살펴보자.

```
1. 번호와 점을 찍고 띄어쓰기를 하면 된다.
2. Lorem ipsum dolor sit amet
3. Consectetur adipiscing elit
4. Integer molestie lorem at massa
5. 위 글이 뭔지 궁금하면 구글링해보자.

1. 숫자를 헷갈려 앞에 1을 써도
1. 아니면 계속 1을 써도
2. 다시 목록을 시작해도
3. 숫자는 그냥 계속 나온다

시작하는 숫자를 지정할 수 있다:

57.  text
1.  text
```

위를 입력하면 아래와 같이 나온다.

1.  번호와 점을 찍고 띄어쓰기를 하면 된다.
2.  Lorem ipsum dolor sit amet
3.  Consectetur adipiscing elit
4.  Integer molestie lorem at massa
5.  위 글이 뭔지 궁금하면 구글링해보자.
6.  숫자를 헷갈려 앞에 1을 써도
7.  아니면 계속 1을 써도
8.  다시 목록을 시작해도
9.  숫자는 그냥 계속 나온다

시작하는 숫자를 지정할 수 있다:

57.  text
58.  text

---

# Blockquotes 인용구

인용구는 마치 목록을 만들 때처럼 `>`기호를 쓰고 한 칸을 띄운 다음 인용할 문구를 적으면 된다.
\
예를 들어

```
> 보통은 `>`개수로 인용 수준을 나타내는데
티스토리는 안된다.
되면 좋겠다.
```

을 입력하면,

> 보통은 `>`개수로 인용 수준을 나타내는데  
> 티스토리는 안된다.  
> 되면 좋겠다.

이렇게 나온다.

`>`기호의 개수로 인용 정도를 조절할 수 있다.
\
티스토리는 지원하지 않는 기능으로 인용 개수를 조절하는 예시만 보여주겠다.

```
> 인용
> > 인용의 인용
```

이렇게 쓰면 된다.

---

# Horizontal Rules 수평선 긋기

내용을 구분할 때 종종 수평선을 긋는다.

수평선은 `---, ***, ===`으로 그을 수 있다.
\
예를 들어

```
---
***
___
```

을 입력하면,

---

---

---

와 같이 나온다.

---

# Tables 표

마크다운으로 간단한 표를 만들 수 있다.
\
바 기호`|`를 사용해서 만들고 첫 줄 밑에는 `---`을 쳐줘야한다.

`---`에서 `-`개수는 그냥 충분히 쳐주자.
\
직접 예시를 통해 살펴보자.

아래와 같이 입력하면,

```
| Option | Description |
| --- | --- |
| data | path to data files to supply the data that will be passed into templates. |
| engine | engine to be used for processing templates. Handlebars is the default. |
| ext | extension to be used for dest files. |

오른쪽으로 정렬하려면 `---`뒤에 `:`을 붙이자.

| Option | Description |
| --: | --: |
| data | path to data files to supply the data that will be passed into templates. |
| engine | engine to be used for processing templates. Handlebars is the default. |
| ext | extension to be used for dest files. |

왼쪽으로 정렬하려면 `:`을 먼저 쓰고 `---`을 붙이자.

| Option | Description |
| :-- | :-- |
| data | path to data files to supply the data that will be passed into templates. |
| engine | engine to be used for processing templates. Handlebars is the default. |
| ext | extension to be used for dest files. |

가운데 정렬하려면 `---`을 `:`으로 감싸주자.

| Option | Description |
| :-: | :-: |
| data | path to data files to supply the data that will be passed into templates. |
| engine | engine to be used for processing templates. Handlebars is the default. |
| ext | extension to be used for dest files. |
```

| Option | Description |
| --- | --- |
| data | path to data files to supply the data that will be passed into templates. |
| engine | engine to be used for processing templates. Handlebars is the default. |
| ext | extension to be used for dest files. |

오른쪽으로 정렬하려면 `---`뒤에 `:`을 붙이자.

| Option | Description |
| --: | --: |
| data | path to data files to supply the data that will be passed into templates. |
| engine | engine to be used for processing templates. Handlebars is the default. |
| ext | extension to be used for dest files. |

왼쪽으로 정렬하려면 `:`을 먼저 쓰고 `---`을 붙이자.

| Option | Description |
| :-- | :-- |
| data | path to data files to supply the data that will be passed into templates. |
| engine | engine to be used for processing templates. Handlebars is the default. |
| ext | extension to be used for dest files. |

가운데 정렬하려면 `---`을 `:`으로 감싸주자.

| Option | Description |
| :-: | :-: |
| data | path to data files to supply the data that will be passed into templates. |
| engine | engine to be used for processing templates. Handlebars is the default. |
| ext | extension to be used for dest files. |

이렇게 나온다.
\
선이 없어서 뭔가 싶지만 잘 보면 표다.
\
~아직 티스토리는 표에 선을 그려주지를 않는다.~

---

# ToDo List 체크박스

아래와 같이 입력해보자.

```
- [ ] ToDos
    - [x] Buy some salad
    - [ ] Brush teeth
    - [x] Drink some water
```

그러면 아래와 같이 나온다.

-   [ ]  ToDos
    -   [x]  Buy some salad
    -   [ ]  Brush teeth
    -   [x]  Drink some water

# MathJax 수식 입력

티스토리에서는 지원하지 않는 기능인데 수식을 입력할 수도 있다.

```
$$
x = {-b \pm \sqrt{b^2-4ac} \over 2a}.
$$

$$
\Gamma(z) = \int_0^\infty t^{z-1}e^{-t}dt\,.
$$
```

위와 같이 입력하면 수식이 튀어나오는데 수식에 대한 문법은 [여기](http://meta.math.stackexchange.com/questions/5020/mathjax-basic-tutorial-and-quick-reference)를 참고하자.