마크다운 파일 작성법

On this page
  1. Headers 헤더 작성
  2. ##H2
  3. ###H3
  4. --- H2
  5. Horizontal Rules 수평선
  6. Line Breaks 줄바꿈
  7. Emphasis 강조
  8. Blockquotes 인용
  9. Lists 목록
  10. Unordered lists 순서가 없는 목록
  11. Ordered lists 순서가 있는 목록
  12. Backslash Escapes 특수문자 표현
  13. 링크와 이미지
  14. 링크
  15. 이미지
  16. 내부(해시) 링크
  17. 코드 블럭
  18. Table 테이블

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

Headers 헤더 작성

# #H1

## ##H2

### ###H3

#### ####H4

##### #####H5

##### ######H6

# === H1

## --- H2

#H1

##H2

###H3

####H4

#####H5
######H6

=== H1

--- H2


Horizontal Rules 수평선

  • - 또는 * 또는 _을 3개 이상 작성하기.
  • 단, - 을 사용할경우 header로 인식할 수 있으니 이전 라인을 비워두어야 한다.
---
---

---

Line Breaks 줄바꿈

  • <br>을 사용해서 줄바꿈을 할 수 있다.
  • 공백 두개도 줄바꿈으로 사용.

Emphasis 강조

  • italic : * 또는 _로 텍스트를 감싸기.
  • bold : ** 또는 __로 텍스트를 감싸기.
  • 취소선 : ~~로 텍스트를 감싸기.

이탤릭체와 두꺼운 텍스트를 같이 사용 가능하다.

Blockquotes 인용

> 으로 시작하는 텍스트. > 는 3개 까지 가능하다.   인용구 안에는 제목이나 리스트, 텍스트박스 등을 넣을 수 있다.

> 인용하기
>
> > 인용하기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을 작성한다.

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

Google

이미지

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

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

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

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

내부(해시) 링크

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

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

코드 블럭

간단한 인라인 코드는 ` 기호로 감싸면 된다.
``` 혹은 ~~~ 로 앞뒤로 감싼다.  
코드가 여러 줄인 경우, 줄 앞에 공백 네 칸을 추가한다.  
``` 옆에 언어를 지정해주면, 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
:---|:---:|---:
left|center|right
1|2|3
4|5|6
7|8|9

테이블 생성

헤더1헤더2헤더3
leftcenterright
123
456
789
Discussion

Comments