Post

마크다운 파일 작성법

마크다운 파일 작성법

원활한 깃허브 블로그 작성을 위해서 마크다운 파일 작성법을 따로 정리해보자. 문법은 인터넷에 검색하면 잘 나오는데. 많이 사용하게 될 내용들 위주로 정리하고 내용을 조금씩 더해보는걸로

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

  1. 인용하기3

Lists 목록

Unordered lists 순서가 없는 목록

* 또는 + 또는 - 을 이용해서 순서가 없는 목록을 만들 수 있다. 들여쓰기를 하면 모양이 변하게 된다.

  • 1     _ 2         _ 3

Ordered lists 순서가 있는 목록

숫자를 기입하면 순서가 있는 목록이 되며, 들여쓰기를 하면 모양이 바뀐다. 숫자를 무엇을 쓰는지는 의미가 없고 자동으로 순서대로 숫자를 매겨준다. 전부 다 숫자 1로 붙여도 알아서 번호를 붙여준다.

  1. 1
  2. 2
  3. 3
  4. 5가 아닌 4

  5. 1     1. 1
  6. 1
  7. 1     1. 1     1. 1

두 종류의 리스트를 혼합해서 사용해도 된다.

Backslash Escapes 특수문자 표현

특수문자 표현시, 문자앞에 \를 넣고 특수문자를 사용하면 된다.

링크와 이미지

링크

대괄호와 소괄호 순서대로 이름과 url을 작성한다.

1
[Google](https://www.google.com "구글")

Google

이미지

링크와 비슷하지만, 앞에 !가 붙는다.   경로 뒤에 “이미지이름” 을 넣을 경우 커서를 올렸을때 나오는 텍스트를 설정 가능하다.

1
![텍스트](이미지파일경로.jpg "이미지이름")

이미지를 링크로 사용할 경우

1
[![텍스트](이미지url)](링크url)

내부(해시) 링크

대괄호 안에 보여지는 내용, 소괄호 안에 이동할 헤드(제목)을 작성한다. 괄호 안에 링크를 쓸 때 띄어쓰기는 - 로 연결하고, 영어는 모두 소문자로 작성해야 된다. vscode에서 작성시 #만 눌러도 자동완성이 뜬다.

1
[링크와 이미지](#링크와-이미지)

코드 블럭

1
2
3
4
간단한 인라인 코드는 ` 기호로 감싸면 된다.
``` 혹은 ~~~ 로 앞뒤로 감싼다.  
코드가 여러 줄인 경우, 줄 앞에 공백 네 칸을 추가한다.  
``` 옆에 언어를 지정해주면, syntax color가 적용된다.
언어markdown
bashbash
c#cs
c++cpp
csscss
diffdiff
html,xmlhtml
httphttp
iniini
jsonjson
javajava
javascriptjavascript
phpphp
perlperl
pythonpython
rubyruby
sqlsql

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
leftcenterright
123
456
789
This post is licensed under CC BY 4.0 by the author.