마크다운(Markdown) 간단 정리

서론

    마크다운은 마크업의 일종으로 읽기도 쓰기도 쉬운 글쓰기 양식이다. 대표적으로 GitHub, 위키, 블로그, Trello 등 다양한 곳에 쓰인다. 혹은 마크다운을 변형하여 GitHub나 discord에서 사용되기도 한다. 마크다운를 익히면 여러 툴의 문서 작업을 이용하기 편하거나 금방 익숙해진다.

---

제목

헤더(==)

    문서 제목과 부제목을 만들 수 있다.

This is an H1
=============
This is an H2
-------------

This is an H1

This is an H2

해쉬(#)

    "#"은 글머리로 1~6까지만 지원

# This is a H1
## This is a H2
### This is a H3
#### This is a H4
##### This is a H5
###### This is a H6

This is a H1

This is a H2

This is a H3

This is a H4

This is a H5

This is a H6

문단

줄 바꿈

     문장 마지막에서 "<br>" 태그를 직접 입력하거나, 줄바꿈을 두 번 하면 된다.

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

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

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

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

블락 인용(>)

    이메일에서 사용하는 "\>" 블럭인용문자를 이용한다. 이 안에서는 다른 마크다운 요소를 포함할 수 있다.

> This is a first blockqute.
>    > This is a second blockqute.
>    >    > This is a third blockqute.

목록

순서 있는 목록

   순서있는 목록은 숫자와 점을 사용한다. 자동으로 내림차순 정렬이 된다.

1. 첫번째
2. 두번째
3. 세번째

1. 첫번째
2. 두번째
3. 세번째

순서 없는 목록

   글머리 기호로 "*, +, -" 등을 지원한다.

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

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

글자 모양

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

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

굵게 쓰거나 두껍게 쓰거나
   기울임꼴 글자는 다음과 같이 쓴다.

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

기울게 쓰면서 기울게 쓴다
   취소선 글자는 다음과 같이 쓴다.

이 글은 ~~취소~~한다.

이 글은 취소한다.

가로줄

아래 줄은 모두 수평선을 만든다. 마크다운 문서를 미리보기로 출력할 때 페이지 나누기 용도로 많이 사용한다.

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

---

---

---

---

---

표

    테이블 헤더를 구분하기 위해, 3개 이상의 -(hyphen/dash) 기호를 사용한다. 테이블 헤더를 구분하며 ":(Colons)" 기호를 추가해 셀(열/칸) 안에 내용을 정렬할 수 있다. 가장 좌측과 가장 우측에 있는 |(vertical bar) 기호는 생략 가능하다.

• ---, :---: 좌측 정렬
• :---:: 가운데 정렬
• ---:: 우측 정렬

| 헤더 | 헤더 | 헤더 |
|---|---|---|
| 셀 | 셀 | 셀 |
| 셀 | 셀 | 셀 |

헤더 | 헤더 | 헤더
---|---|---
셀 | 셀 | 셀
셀 | 셀 | 셀

헤더	헤더	헤더
셀	셀	셀
셀	셀	셀

코드

    <pre>, <code> 태그로 변환되는 '코드(Code)'를 표현한다.

<pre>
<code>
public class BootSpringBootApplication {
  public static void main(String[] args) {
    System.out.println("Hello, Honeymon");
  }

}
</code>
</pre>

public class BootSpringBootApplication {
  public static void main(String[] args) {
    System.out.println("Hello, Honeymon");
  }

}

     \` (백틱) 기호를 사용할 수도 있다.

```
public class BootSpringBootApplication {
  public static void main(String[] args) {
    System.out.println("Hello, Honeymon");
  }
}
```

public class BootSpringBootApplication {
  public static void main(String[] args) {
    System.out.println("Hello, Honeymon");
  }
}

링크

참조링크

    참조 링크는 "[보여줄 문자][링크 아이디]"로 작성할 수 있다. 링크 아이디는 추후에 정의할 수 있다.

[link keyword][id]
[id]: URL "Optional Title here"

// code
Link: [Google][googlelink]
[googlelink]: https://google.com "Go google"

Link: [Google][googlelink]
[googlelink]: https://google.com "Go google"

외부링크

    외부 링크는 직접 주소를 넣어 "[보여줄 문자][주소]" 형태로 작성한다. 이 방식을더욱 선호한다.

[Title](link)
[Google](https://google.com, "google link")

Google

자동연결

    일반적인 URL 혹은 이메일주소인 경우 적절한 형식으로 링크를 형성한다.

* 외부링크: <http://example.com/>
* 이메일링크: <address@example.com>

• 외부링크: http://example.com/
• 이메일링크: address@example.com

이미지

   이미지를 직접 넣으면 자동으로 생성되기도 하지만, 직접 불러온다면 다음과 같다.

![Alt text](/path/to/img.jpg)
![Alt text](/path/to/img.jpg "Optional title")

   사이즈 조절 기능은 없기 때문에  를 이용한다.

<img src="/path/to/img.jpg" width="450px" height="300px" title="px(픽셀) 크기 설정" alt="RubberDuck"></img><br/>
<img src="/path/to/img.jpg" width="40%" height="30%" title="px(픽셀) 크기 설정" alt="RubberDuck"></img>

주석

   <!-- -->, \[//\]: # 기호를 사용해, 주석(Comment)을 표현한다.

-- 시작 --

<!-- 안녕하세요. -->
[//]: # (안녕하세요.)
[//]: # "안녕하세요."
[//]: # '안녕하세요.'

-- 종료 --

-- 시작 --

-- 종료 --

---

주섬주섬

   티스토리의 마크다운 모드는 익숙하지 않아, 조금 차이가 있을 수 있다.

참고

Markdown Guide