[Etc] Markdown 사용법

October 18, 2023

0. 들어가며

Github를 구경하다 보면 .md 파일을 자주 만나게 된다.  
이런 파일들은 Markdown 문법으로 작성된 파일이다.  
본 게시글도 Markdown으로 작성되었다.

1. Markdown이란?

Markdown은 일반 텍스트 기반의 경량 마크업 언어이다.
마크업 언어란 태그 등을 이용해 문서나 데이터의 구조 등을 명시하는 언어를 말한다.
Markdown은 일반 텍스트로 서식이 있는 문서를 작성하는 데 사용되며,
일반 마크업 언어에 비해 문법이 쉽고 간단한 것이 특징이다.

2. Markdown 문법

	# 제목 1
	## 제목 2
	### 제목 3
	#### 제목 4
	##### 제목 5
	###### 제목 6

제목 1

제목 2

제목 3

제목 4

제목 5

제목 6

2-2. 강조(Emphasis)

이텔릭체는 *별표(asterisks)* 또는 _언더바(underscore)_를 사용한다.
볼드체는 **별표(asterisks)** 또는 __언더바(underscore)__를 사용한다.
이텔릭체와 볼드체는 혼용 가능하다. **_예를 들면_** 또는 __*이렇게*__
취소선은 ~~물결표시(tilde)~~를 사용한다.
밑줄은 <u>abc</u>를 사용한다.

이텔릭체는 별표(asterisks) 또는 _언더바(underscore)_를 사용한다.
볼드체는 별표(asterisks) 또는 언더바(underscore)__를 사용한다.
이텔릭체와 볼드체는 혼용 가능하다. **예를 들면** 또는 __이렇게
취소선은 ~~물결표시(tilde)~~를 사용한다.
밑줄은 abc를 사용한다.

2-3. 목록(Lists)

	1. first
	2. second
		- second.first
		- second.second
	3. third

	1. first
		- dash
		* asterisks
		+ plus

	- dash
	* asterisks
	+ plus

first
second
- second.first
- second.second
third
first
- dash
- asterisks
- plus

dash
asterisks
plus

2-4. 링크(Links)

[GOOGLE](https://google.com)

[Naver](https://naver.com "링크 설명")  

[상대적 참조](../users/hyuim)

[Hyuim's Blog][My Blog Link]

문서 안에서 [참조 링크]를 사용할 수도 있다.

아래와 같이 일반 URL이나 꺾쇠 안의 URL은 자동으로 링크로 인식한다.
구글 홈페이지 : https://google.com
네이버 홈페이지 : <https://naver.com>

[참조 링크]: https://google.com "구글로 이동하기"
[Hyuim's Blog]: https://hyun-soon.github.io/

GOOGLE

Naver

상대적 참조

[Hyuim’s Blog][My Blog Link]

문서 안에서 참조 링크를 사용할 수도 있다.

아래와 같이 일반 URL이나 꺾쇠 안의 URL은 자동으로 링크로 인식한다.

구글 홈페이지 : https://google.com

네이버 홈페이지 : https://naver.com

2-5. 이미지(Images)

링크와 비슷하지만 앞에 ! 가 붙는다.

![image name](https://cdn.pixabay.com/photo/2019/12/22/17/13/french-bulldog-4713013_1280.jpg)

image name

2-6. 코드블록(Code block)

코드를 ```로 감싼다.
``` 옆에 언어 종류를 적어주면 해당 언어의 문법에 따라 강조 효과를 줄 수 있다.

	```c++
		#include <iostream>
	
		using namespace std;
	
		int main()
		{
			cout << "abc\n";
			return (0);
		}
	```

	#include <iostream>

	using namespace std;

	int main()
	{
		cout << "abc\n";
		return (0);
	}

2-7. 표(Table)

헤더 셀을 구분할 때 3개 이상의 - 가 필요하다.
헤더 셀을 구분하면서 : 으로 열을 나눌 수 있다.
가장 좌측과 우측에 있는 | 는 생략 가능하다.

| Col1 | Col2 | Col3 |
| --- |: --- |: --- |
| a | b | c |
| d | e | f |
| g | h | i |

Col1 | Col2 | Col3
--- |: --- |: ---
a | b | c
d | e | f
g | h | i

Col1	Col2	Col3
a	b	c
d	e	f
g	h	i

Col1	Col2	Col3
a	b	c
d	e	f
g	h	i

2-8. 인용문(Block Quote)

인용문 예시
> 이렇게 인용문을 사용할 수 있습니다.

중첩된 인용문
> 중첩된 인용문도
>> 이렇게 하면
>> 사용할 수
>>> 있습니다.
>>> example1
>>> example2
>>> example3

인용문 예시

이렇게 인용문을 사용할 수 있습니다.

중첩된 인용문

중첩된 인용문도

이렇게 하면 사용할 수

있습니다.
example1
example2
example3

2-9. 수평선(Horizontal Rule)

다음의 기호들을 3개씩 사용하면 수평선을 만들 수 있다.

---
(Hyphens)

***
(Asterisks)

___
(Underscores)

(Hyphens)

(Asterisks)

(Underscores)

2-10. 줄바꿈(Line Breaks)

일반 줄바꿈이 동작하지 않는다면, 2번의 띄어쓰기를 줄바꿈으로 사용할 수 있다.

가나다라  <!--2칸의 공백-->
마바사

가나다라
마바사

Hyunsoon Im