마크다운(MarkDown) 작성법

2021-04-13

마크다운(MarkDown)이란?

마크다운(MarkDown)은 산문을 읽고, 쓰고, 편집하기 쉬운 목적으로 만들어진 문서 작성을 위한 형식으로 사용되며, 문법이 간결하고 HTML삽입이 가능합니다.

또한 마크다운을 작성한 문서의 표현 방식은 CSS의 설정에 따라 달라집니다.

사람들이 자주 쓰는 Discord또한 일부 마크다운 문법을 지원합니다.


마크다운 장점

  1. 문법이 간결하고 쉽다.
  2. 마크다운은 모든 것에 사용할 수 있습니다. (웹 사이트, 문서, 메모, 기술 문서 등)
  3. 마크다운은 지원하는 플랫폼이 많습니다. ( Github, Discord 등)
  4. 마크다운은 대부분의 환경에서 편집, 작성이 가능합니다. (메모장에서도 가능)
  5. 텍스트로 저장되기 때문에 용량이 적어 보관이 용이합니다.

마크다운 단점

  1. 모든 HTML의 문법을 대신하지 못합니다.
  2. 표준이 없기 때문에 도구에 따라 변환방식 또는 생성물이 다릅니다.

마크다운(MarkDown) 문법(Syntax)


헤더,제목,섹션(Header)

글머리 1~6까지 크키 조절이 가능합니다.

글머리가 많아질수록 글자의 크기가 달라집니다.

마크다운은 Setextatx 두 가지 스타일의 헤더를 지원합니다.


# Setext Style Header

제목1(<h1>, =)과 제목2(<h2>, -)으로 표현할 수 있습니다.


This is an H1
=============

This is an H1
-------------

This is an H1

This is an H1


# atx Style Header

1부터 6까지 해시 기호(#)의 개수에 따라 글자 크기가 달라집니다.


# H1 tag
## H2 tag
### H3 tag
#### H4 tag
##### H5 tag
###### H6 tag

H1 tag

H2 tag

H3 tag

H4 tag

H5 tag
H6 tag

목록 또는 리스트(List)

순서 있는 목록, 순서 없는 목록 두 가지를 쉽게 작성할 수 있습니다.


# 순서 없는 목록

[+ * -] 3개의 글머리로 순서 없는 목록을 정렬할 수 있습니다.


+ 나는 1번째
  + 나는 1.1번째
    + 나는 1.2번째
* 나는 2번째
- 나는 3번째

  • 나는 1번째
    • 나는 1.1번째
      • 나는 1.2번째
  • 나는 2번째
  • 나는 3번째

# 순서 있는 목록

숫자. 형식으로 순서 있는 목록을 작성할 수 있습니다.


1. 1번 리스트
    1. 1-1번 리스트
2. 1번 리스트
3. 1번 리스트
    1. 3-1번 리스트
    2. 3-2번 리스트
4. 1번 리스트

  1. 1번 리스트
    1. 1-1번 리스트
  2. 1번 리스트
  3. 1번 리스트
    1. 3-1번 리스트
    2. 3-2번 리스트
  4. 1번 리스트

인용(BlockQuote)

> 꺽쇠 기호를 이용하여 작성할 수 있습니다.


> 인용 1
>> 인용 2
>>> 인용 3

> 인용 4

>> 인용 5

인용 1

인용 2

인용 3

인용 4

인용 5


강조(Emphasis)

굵게, 기울이기, 취소선 등의 텍스트를 강조를 할 수 있습니다.


_기울여 쓰기_

__굵게__

*기울여 쓰기*

**굵게**

~취소선~

~~취소선~~

<u>밑줄은 마크다운에서 지원하지 않으므로 HTML를 사용하세요</u>

_**중복 가능합니다.**_

~~__중복 가능합니다.__~~

기울여 쓰기

굵게

기울여 쓰기

굵게

~취소선~

취소선

밑줄은 마크다운에서 지원하지 않으므로 HTML을 사용하세요

중복 가능합니다.

중복 가능합니다.


수평선 (Horizontal Rule)

영역을 나누거나 줄을 표시할 때 [-, *, _]를 이용하여 수평선을 작성할 수 있습니다.

---

영역 1

***

영역 2

___

끝


영역 1


영역 2



줄바꿈(Line Breaks)

새로운 라인으로 줄 바꿈 하기 위해서는 줄 바꿈 2번 또는 <br> 태그를 사용해야 합니다.

알파벳의 구글 딥마인드에서 개발한 바둑 인공지능 프로그램. <!-- 엔터 한번 -->
프로기사를 맞바둑으로 이긴 최초의 프로그램이기도 하다. <!-- 엔터 두번 -->

이름에서 "Go"란 일본어로 바둑을 뜻하는 碁(바둑 기. 일본어 음독은 "고")[2][3]를 의미한다.<br>
이는 일반적으로 서구 언론에서 바둑을 의미할 때 "고"란 말을 쓰기 때문이다.

알파벳의 구글 딥마인드에서 개발한 바둑 인공지능 프로그램. 프로기사를 맞바둑으로 이긴 최초의 프로그램이기도 하다.

이름에서 “Go”란 일본어로 바둑을 뜻하는 碁(바둑 기. 일본어 음독은 “고”)[2][3]를 의미한다.
이는 일반적으로 서구 언론에서 바둑을 의미할 때 “고”란 말을 쓰기 때문이다.


체크 박스(Check Box)

[] 대괄호를 이용하여 체크 박스를 만들 수 있습니다.

[x] 대괄호 안에 x를 넣으면 체크된 상태로 됩니다.

- [ ] 공부하기
- [x] 프로젝트 회의하기
- [X] 코드 100줄 이상 작성하기
- [o] 잘못된 예
  • 공부하기
  • 프로젝트 회의하기
  • 코드 100줄 이상 작성하기
  • [o] 잘못된 예

테이블(Table)

차트를 정렬할 때 [| , : , -] 3가지의 특수문자로 작성할 수 있습니다.


| 먹고싶은 과일 | 먹고싶은 고기 | 먹고싶은 음료수 |
|:- | :-: | -:|
| 사과 | LA갈비 | 몬스터 |
| 배 | 닭갈비 | 파워에이드 |
| 망고 | 제육볶음 | 2% |

| 재밌는 드라마 | 드라마 제작사 | 드라마 개봉일 | 드라마 방송사 |
| - | - | - | - |
| 괴물 | 셀트리온엔터테인먼트 | 2021년 | JTBC |
| 라이브 | 지티스트 (GT:st), 김규태 | 2021년 | tvN |
| 쌈 마이웨이 | (주)팬엔터테인먼트, 김희열  | 2021년 | KBS 2TV |

먹고싶은 과일 먹고싶은 고기 먹고싶은 음료수
사과 LA갈비 몬스터
닭갈비 파워에이드
망고 제육볶음 2%
재밌는 드라마 드라마 제작사 드라마 개봉일 드라마 방송사
괴물 셀트리온엔터테인먼트 2021년 JTBC
라이브 지티스트 (GT:st), 김규태 2021년 tvN
쌈 마이웨이 (주)팬엔터테인먼트, 김희열 2021년 KBS 2TV

[title](link) 형식으로 앵커(anchor)를 만들 수 있습니다.


[example](https://example.com)

[naver](https://www.naver.com)

[링크(Link)](#링크link)

[``test``](https://example.com)

+ [test](https://example.com)

example

naver

링크(Link)

test


이미지(Image)

![title](Image src) 형식으로 이미지를 나타낼 수 있습니다.


![자기야 왜 칭얼거려](https://i.imgur.com/XletaX7.jpgg)

![잉?](https://i.imgur.com/SiQDzMB.jpg)

자기야 왜 칭얼거려

잉?


코드블록(Code Block)

코드 블록을 나타내는 방법은 3가지의 방법이 있습니다.


# 역따옴표


```
역따옴표 Code Block
```

```python
import requests

rg = requests.get
rp = requests.post

_rg = rg("https://google.com").text
_rp = rp("https://google.com").text
```

```js
var add = (num1, num2) => {
    return num1 + num2;
}
console.log(add(1,2));
```

역따옴표 Code Block
import requests

rg = requests.get
rp = requests.post

_rg = rg("https://google.com").text
_rp = rp("https://google.com").text
var add = (num1, num2) => {
    return num1 + num2;
}
console.log(add(1,2));

# 물결표


~~~
물결표 Code Block
~~~

~~~sql
SELECT 1;
SELECT * FROM Login WHERE id='admin';
SELECT group_concat(table_name) FROM information_schema.tables WHERE table_schema=database();
~~~

~~~js
var add = (num1, num2) => {
    return num1 + num2;
}
console.log(add(1,2));
~~~

물결표 Code Block
SELECT 1;
SELECT * FROM Login WHERE id='admin';
SELECT group_concat(table_name) FROM information_schema.tables WHERE table_schema=database();
var add = (num1, num2) => {
    return num1 + num2;
}
console.log(add(1,2));

# 탭(Tab)


    탭(Tab) Code Block
    Hello!

탭(Tab) Code Block
Hello!

후기


마크다운은 문법이 간결하고 원하는 대로 쉽게 만들 수 있어서 자주 애용하는데 이 블로그를 쓰면서 새로운 문법도 알게 되었습니다.

잘못 적은 문법이 있다면 마음껏 댓글에 피드백 주세요!