마크다운 문법

1. 마크다운 이란

Markdown은 텍스트를 기반으로 한 마크업 언어이다.
마크다운을 사용하면 글을 쉽게 쓰고 읽을 수 있다. 또한 마크다운은 HTML로 변환이 가능하다.
실제 사용해보니 웹페이지에서 마크다운 문법은 HTML 태그로 변환된다.

GitHub에서 마크다운은 Readme.md 파일 또는 프로젝트를 진행 시 접근자를 위한 설명서,
개인이 기록을 위한 메모 등과 같이 시각적 표현이 필요할 때 간단하고 직관적으로 활용 할 수 있다.
마크다운으로 작성된 파일은 .md의 확장자를 가진다.

2. 마크다운 문법

2.1. 헤더

---

• H1 : 큰 제목 : 문서의 제목 : <h1></h1>

  문서의 제목은 H1

  사례: 
  문서의 제목은 H1
  ===============
  

  ---

• H2 : 작은 제목 : 문서의 부제목 : <h2></h2>

  문서의 부제목은 H2

  사례: 
  문서의 부제목은 H2
  -----------------
  

  ---

• 글머리 문법 : H1 ~ H6 : <h1></h1> ~ <h6></h6>

  글머리 문법 H1

  글머리 문법 H2

  글머리 문법 H3

  글머리 문법 H4

  글머리 문법 H5

  글머리 문법 H6

  문법: 
  # 글머리 문법 H1
  ## 글머리 문법 H2
  ### 글머리 문법 H3
  #### 글머리 문법 H4
  ##### 글머리 문법 H5
  ###### 글머리 문법 H6

2.2. 링크

---

• 외부 링크

  구글

  문법:
  [이름](링크, 설명(option))
  
  사례: 
  [구글](https://google.com, "구글로 이동")

  ---

• 참조 링크

  구글

  문법: 
  [링크 이름][id]
  [id]: 링크 "설명(option)"
    
  사례: 
  [구글][googleLink]
  [googleLink]: https://google.com "구글로 이동"

  ---

• 자동 링크

  자동 외부 링크: https://google.com/
  자동 이메일 링크: aaa@kakao.com

  사례: 
  자동 외부 링크: <링크>
  자동 이메일 링크: <이메일>

2.3. 이미지

---

문법:
![이름](경로)

사례: 
![profileImage](/assets/images/logo.png)

또한 정렬 및 이미지 크기 조절도 가능함:
css 파일 만들고 .center { display: block; maring: auto; }
![profileImage](url){: width="50%" height="50%"}{: .center}

2.4. 코드

---

일반적인 키보드 배열에서 Tab키 위, 숫자 배열 가장 왼쪽에 존재하는 `(backticks)키를 사용하여 코드를 나타낼 수 있다.
한 개의 backticks 쌍으로 인라인 코드를 나타낼 수 있고, 세 개의 backticks 쌍으로 코드 블럭을 나타낼 수 있다.

한 개의 backticks 쌍
backticks

세 개의 backticks 쌍

code block
    

backticks 표현 방법
`backticks` 나타내기

2.5. 인용 문자

---

사례 1

한줄 인용

사례 2

여러 줄

인용

사례 3

이중

인용

사례 4:

블록 속

• 문법 사용

사례 1:
> 한줄 인용

사례 2:
> 여러 줄
>
> 인용

사례 3:
> 이중
>
>> 인용

사례 4:
> 블록 속
>
>> - ***문법 사용*** 

2.6. 목록

---

• 순서있는 목록

  사례 1

  1. 일번
  2. 이번
  3. 삼번
  4. 사번

  사례 2

  1. 일번
  2. 이번
  3. 삼번
     1. 일번
     2. 이번
  4. 사번

  사례 1:
  1. 일번
  2. 이번
  3. 삼번
  4. 사번
  
  사례 2:
  1. 일번
  2. 이번
  3. 삼번
      1. 일번
      2. 이번
  4. 사번
  

  ---

• 순서없는 목록

  순서없는 목록에서 목록은 *, -, + 기호를 사용하여 나타낼 수 있다.
  서브 목록을 사용할 때 혼합된 사용도 허용한다.

  사례 1

  • 일번
  • 이번
  • 삼번
  • 사번

  사례 2

  • 일번
  • 이번
  • 삼번
    • 일번
    • 이번
  • 사번

  사례 3

  • 일번
    • 이번
      • 삼번

  사례 1:
  - 일번
  - 이번
  - 삼번
  - 사번
  
  사례 2:
  - 일번
  - 이번
  - 삼번
      - 일번
      - 이번
  - 사번
  
  사례 3:
  - 일번
    + 이번
      * 삼번
  

2.7. 수평선

---

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

2.7. 강조

---

기울게 기울게

두껍게 두껍게

취소선 취소선

밑줄 밑줄

기울게, 두껍게 혼합형

기울게: 
*기울게*
_기울게_

두껍게:
**두껍게**
__두껍게__

취소선:
~~취소선~~

밑줄:
밑줄

기울게, 두껍게:
***혼합형***
___혼합형___
__*혼합형*__
**_혼합형_**

2.7. 줄바꿈

---

마크다운에서 줄바꿈은 띄어쓰기를 3회 입력하면 된다. 마크다운 편집기 상에서 엔터키로 줄내림을 하면 띄어쓰기가 입력된다.

띄어쓰기 X
마크다운에서의 줄바꿈

띄어쓰기 O
마크다운에서의
줄바꿈

띄어쓰기 X: 
마크다운에서의 
줄바꿈

띄어쓰기 O:   
마크다운에서의   
줄바꿈

2.8. 각주

---

마크다운에서의 각주¹이다.

마크다운에서의 각주[^1]이다.   

[^1]: Markdown Footnotes

참고 자료

HEROPY님의 MarkDown 사용법 총정리
ihoneymon님의 how to write by markdown
Markdownguide - Basic Syntax
Markdownguide - Extended Synatx

각주

1. Markdown Footnotes ↩