마크다운 파일 작성법
원활한 깃허브 블로그 작성을 위해서 마크다운 파일 작성법을 따로 정리해보자. 문법은 인터넷에 검색하면 잘 나오는데. 많이 사용하게 될 내용들 위주로 정리하고 내용을 조금씩 더해보는걸로
Headers 헤더 작성
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
# #H1
## ##H2
### ###H3
#### ####H4
##### #####H5
##### ######H6
# === H1
## --- H2
#H1
##H2
###H3
####H4
#####H5
######H6
=== H1
— H2
Horizontal Rules 수평선
- - 또는 * 또는 _을 3개 이상 작성하기.
- 단, - 을 사용할경우 header로 인식할 수 있으니 이전 라인을 비워두어야 한다.
1
2
3
4
---
---
---
Line Breaks 줄바꿈
- <br>을 사용해서 줄바꿈을 할 수 있다.
- 공백 두개도 줄바꿈으로 사용.
Emphasis 강조
- italic : * 또는 _로 텍스트를 감싸기.
- bold : ** 또는 __로 텍스트를 감싸기.
- 취소선 : ~~로 텍스트를 감싸기.
이탤릭체와 두꺼운 텍스트를 같이 사용 가능하다.
Blockquotes 인용
> 으로 시작하는 텍스트. > 는 3개 까지 가능하다. 인용구 안에는 제목이나 리스트, 텍스트박스 등을 넣을 수 있다.
1
2
3
4
5
> 인용하기
>
> > 인용하기2
> >
> > 1. 인용하기3
인용하기
인용하기2
- 인용하기3
Lists 목록
Unordered lists 순서가 없는 목록
* 또는 + 또는 - 을 이용해서 순서가 없는 목록을 만들 수 있다. 들여쓰기를 하면 모양이 변하게 된다.
- 1 _ 2 _ 3
Ordered lists 순서가 있는 목록
숫자를 기입하면 순서가 있는 목록이 되며, 들여쓰기를 하면 모양이 바뀐다. 숫자를 무엇을 쓰는지는 의미가 없고 자동으로 순서대로 숫자를 매겨준다. 전부 다 숫자 1로 붙여도 알아서 번호를 붙여준다.
- 1
- 2
- 3
5가 아닌 4
- 1 1. 1
- 1
- 1 1. 1 1. 1
두 종류의 리스트를 혼합해서 사용해도 된다.
Backslash Escapes 특수문자 표현
특수문자 표현시, 문자앞에 \를 넣고 특수문자를 사용하면 된다.
링크와 이미지
링크
대괄호와 소괄호 순서대로 이름과 url을 작성한다.
1
[Google](https://www.google.com "구글")
이미지
링크와 비슷하지만, 앞에 !가 붙는다. 경로 뒤에 “이미지이름” 을 넣을 경우 커서를 올렸을때 나오는 텍스트를 설정 가능하다.
1

이미지를 링크로 사용할 경우
1
[](링크url)
내부(해시) 링크
대괄호 안에 보여지는 내용, 소괄호 안에 이동할 헤드(제목)을 작성한다. 괄호 안에 링크를 쓸 때 띄어쓰기는 - 로 연결하고, 영어는 모두 소문자로 작성해야 된다. vscode에서 작성시 #만 눌러도 자동완성이 뜬다.
1
[링크와 이미지](#링크와-이미지)
코드 블럭
1
2
3
4
간단한 인라인 코드는 ` 기호로 감싸면 된다.
``` 혹은 ~~~ 로 앞뒤로 감싼다.
코드가 여러 줄인 경우, 줄 앞에 공백 네 칸을 추가한다.
``` 옆에 언어를 지정해주면, syntax color가 적용된다.
| 언어 | markdown |
|---|---|
| bash | bash |
| c# | cs |
| c++ | cpp |
| css | css |
| diff | diff |
| html,xml | html |
| http | http |
| ini | ini |
| json | json |
| java | java |
| javascript | javascript |
| php | php |
| perl | perl |
| python | python |
| ruby | ruby |
| sql | sql |
Table 테이블
헤더와 셀을 구분할 때 3개 이상의 - hypen/dash 기호가 필요하다. 헤더와 셀을 구분하면서 :colons 기호로 셀 안에 내용을 정렬할 수 있다. 가장 좌측과 우측에 있는 vertical bar 기호는 생략 가능하다.
1
2
3
4
5
6
7
테이블 생성
헤더1|헤더2|헤더3
:---|:---:|---:
left|center|right
1|2|3
4|5|6
7|8|9
테이블 생성
| 헤더1 | 헤더2 | 헤더3 |
|---|---|---|
| left | center | right |
| 1 | 2 | 3 |
| 4 | 5 | 6 |
| 7 | 8 | 9 |