Mark Down (마크다운)

소개

---

마크다운(Mark Down)은 일반 텍스트 문서의 양식을 편집하기 위한 문법으로 해당 문법으로 작성된 파일은 ".md"의 확장자를 가진다. (인터넷에서 흔히 볼수 있는 README.md 파일이 바로 마크다운 문법으로 작성된 파일이다)

마크다운을 이용해 작성된 문서는 HTML 등 다른 문서 형태로 쉽게 변환이 가능하지만 모든 HTML 마크업을 지원하지는 않는다.

문법

---

제목 (Header)

---

<h1>부터 <h6>까지 '#'를 통해 제목 표현이 가능하다.

사용법

# 제목 <h1>
## 제목 <h2>
### 제목 <h3>
#### 제목 <h4>
##### 제목 <h5>
###### 제목 <h6>

결과

제목 <h1>

제목 <h2>

제목 <h3>

제목 <h4>

제목 <h5>

제목 <h6>

강조 (Emphasis)

---

이텔릭체 표현을 위해서 ' * ' 혹은 ' _ '를 표현하고자 하는 곳에 앞뒤로 하나씩 붙여 준다.
볼드체 표현을 위해서는 ' * ' 혹은 ' _ '를 표현하고자 하는 곳에 앞뒤로 두개씩 붙여 준다.
취소선 표현을 위해서는 **' ~ '를 표현하고자 하는 곳에 앞뒤로 붙여 준다.

사용법

*이텔릭체* or _이텔릭체_
**볼드체** or __볼드체__
~취소선~

결과

이텔릭체 or 이텔릭체
볼드체 or 볼드체
취소선

목록 (List)

---

목록을 표현하는 방법에는 크게 숫자를 이용하는 방법과 ' - ', ' * ', ' + ' 기호를 이용하는 방법이 있다.
기호를 사용하는 경우 기호 뒤에 띄어쓰기를 해야 하면 하위 목록을 위해서는 탭을 이용하여 하위 목록을 만들 수 있다.

사용법

1. 목록 1  
    1. 하위 목록 1  
    2. 하위 목록 2 
2. 목록 2  
    1. 하위 목록 1  
    2. 하위 목록 2

- 목록 1
    - 하위 목록 (+)
    - 하위 목록 (*)
    - 하위 목록 (-)
- 목록 2
    - 하위 목록 (+)
    - 하위 목록 (*)
    - 하위 목록 (-)

결과

1. 목록 1
   1. 하위 목록 1
   2. 하위 목록 2
2. 목록 2
   1. 하위 목록 1
   2. 하위 목록 2

• 목록 1
  • 하위 목록 (+)
  • 하위 목록 (*)
  • 하위 목록 (-)
    
    
• 목록 2
  • 하위 목록 (+)
  • 하위 목록 (*)
  • 하위 목록 (-)

표 (Table)

---

표는 헤더셀과 바디셀로 나눌 수 있다.
각각의 셀은 " | "로 구분할 수 있고 헤더와 바디의 구분은 그 사이에 " --- "을 넣어 줌으로써 구분이 가능하다.
텍스트 정렬은 " : " 로 가능하다 해당 기호를 " --- " 왼쪽에 두면 좌측 정렬, 오른쪽은 우측 정렬, 좌우에 하나씩 추가하면 중앙 정렬이 된다.

사용법

| 이름 | 나이 | 성별 |
| :--- | :---: | ---: |
| 홍길동 | 23 | 남 |
| 이은희 | 33 | 여 |
| 남궁옥분 | 76 | 여 |

결과

이름	나이	성별
홍길동	23	남
이은희	33	여
남궁옥분	76	여

인용문 (BlockQuote)

---

인용문 표기를 위해서는 문장 시작 부분에 " > "을 추가하면 된다.

사용법

> 인용문을 가져다 쓸 때는 이렇게 쓰면 됩니다.
>> ">"를 하나 더 붙이면 중첩 인용문을 만들 수도 있지요.

결과

인용문을 가져다 쓸 때는 이렇게 쓰면 됩니다.

">"를 하나 더 붙이면 중첩 인용문을 만들 수도 있지요.

줄바꿈

---

줄바꿈은 띄어쓰기 2번(space * 2)을 하거나 " <br> "을 붙여 주면 된다.
간혹 띄어쓰기 2번을 추가했음에도 불구하고 줄바꿈이 되지 않는다면 " <br> "을 넣어주면 확실히 줄바꿈이 된다.

사용법

줄바꿈은 문장 마지막에 띄어쓰기 2번으로 가능  
혹은 "<br>"도 사용 가능하다.<br>이렇게 말이다.

결과

줄바꿈은 문장 마지막에 띄어쓰기 2번으로 가능
혹은 "<br>"도 사용 가능하다.
이렇게 말이다.

수평선

---

수평선은 " - ", " * ", " _ "을 3개 이상 입력하여 추가할 수 있다.

사용법

---
(Hyphens)

***
(Asterisks)

___
(Underscores)

결과

---

(Hyphens)

---

(Asterisks)

---

(Underscores)

코드 블럭

---

코드 블럭을 만드는 방법은 " ` "을 3번 이상 연속(```)으로 입력하는 것이다.
그리고 그 뒤에 코드 종류를 적어주면 해당 스타일에 맞게 하이라이팅 되는 것을 볼 수 있다.

사용법

.```java
public void printHelloWorld() {
    System.out.println("Hello world");
}
.```

실제로는 "```" 앞의 "."을 삭제해야 한다.

결과

public void printHelloWorld() {
    System.out.println("Hello world");
}

링크

---

[] 안에 화면에 표시될 이름을 넣고 그 뒤 () 안에 링크 주소를 추가한다.
[참조 링크]:[참조 링크 URL] 와 같은 방법으로 참조 링크도 만들어서 사용할 수 있다.

사용법

[티스토리](https://www.tistory.com/)
[네이버][네이버 참조]

물론 아래와 같이 일반 URL을 사용하면 자동으로 링크 동작이 수행된다.

다음: https://www.daum.net/

[네이버 참조]:[https://www.naver.com/)

결과

티스토리
네이버

물론 아래와 같이 일반 URL을 사용하면 자동으로 링크 동작이 수행된다.


다음: https://www.daum.net/

이미지 삽입

---

기본적으로 마크다운은 웹 상의 이미지 삽입을 지원하는데 그 방법은 아래와 같다.


여기서 "이미지 이름"은 생략가능한데 역할은 이미지 위에 마우스 커서를 올렸을 때 표시되는 이름이다.

사용법

![웹 이미지](https://6.viki.io/image/a11230e2d98d4a73825a4c10c8c6feb0.jpg?x=b&a=0x0&s=460x268&e=t&f=t&cb=1, "아이유")

결과

다음으로는 웹상의 이미지 URL을 통해 이미지 삽입하는 방법에 대해 알아 보자.

삽입된 이미지에 링크를 거는 방법은 아래와 같다.

사용법

[![웹 이미지](https://6.viki.io/image/a11230e2d98d4a73825a4c10c8c6feb0.jpg?x=b&a=0x0&s=460x268&e=t&f=t&cb=1)](https://thinking-jmini.tistory.com/)

결과

이상으로 기본적인 마크다운 문법에 대해서 알아 보았다.
마크다운은 많은 것을 지원하지는 않지만 매우 쉽고 직관적으로 글을 쓸 수 있다는 점에서 매우 편리하다.

그리고 마크다운 문법에서 지원하지 않는 기능에 대해서는 Raw HTML 문법 사용을 통해서 대부분 지원 가능하니 유용하게 사용하도록 하자.