마크다운 사용 방법(How to use Markdown)
- Study of GifMan/Github
- 2021. 3. 19.
Markdown 문법
마크다운은 개발자라면 필수적으로 알아야하는 문법중 하나이다.
간단히 설명하자면 워드, 한글 등의 문서작업을 메모장으로 구현한다고 생각하면 된다. 글씨의 크기, 단 나누기, 표만들기, 이미지 넣기 등등을 단순한 문법만 알게 된다면 모두 구현이 가능하다.
마크다운을 통하여 작성한 문서는 각각의 호완성이 뛰어나 깃허브, 블로그 등에 적용에 용이하다. 물론 조금씩 문법이 추가되기는 하여도 기본적인 markdown의 형식은 동일하다. 아 그리고 티스토리에도 사용 가능하다.
약 10분 이내의 시간으로 Markdown에서 꼭 필요한 문법들을 알아가는 방법은 어렵지 않을 것이다. 해당 글은 jupyternote을 통하여 작성하였다.
'적용 예' 역시 jupyternote에서 Markdown 으로 작성된 것을 그대로 불러온 것이다.
1. 헤딩(Heading)
heading은 #의 갯수와 띄어쓰기로 생성된다. #의 갯수에 따라 문자의 크기가 변화한다.
# size1
## size2
### size3
#### size4
##### size5
###### size6
- #의 갯수가 늘어날수록 header의 크기가 작아진다.
- size는 # 6개 까지만 지원한다. ##### size 5의 실제크기
- 기본 폰트 크기와 size 5의 크기는 비슷한 편이다.
2. 수평선(line)
아래의 모든 문자는 수평선을 만든다. 보통 문단을 나눌 때 사용한다.
---
- - -
___
***
- 적용 예
3. 텍스트 강조(Text attributes)
글씨를 강조할때는 강조하고 싶은 글씨 양 옆에 특수문자를 추가한다.
This is **bold** text.
This is the *italic* text.
This is ~~strickthrough.~~
- 적용 예
This is bold text.
This is the italic text.
This is ~~strickthrough.
> Don't forget to code your dream.
> > Don't forget to code your dream.
> > > Don't forget to code your dream.
- 적용 예시
Don't forget to code your dream.
Don't forget to code your dream.
Don't forget to code your dream.
- 인용문 내부에서 마크다운의 문법이 사용 가능하다.
5. 리스트(list)
5-1. 숫자 리스트(Numbered list)
순서가 있는 목록은 숫자와 점을 사용한다.
1. first
2. second
3. third
- 적용 예
- first
- second
- third
5-2. 블릿 리스트(bullet list)
순서가 없는 리스트는 (+,-,*) 등을 사용한다.
* first
+ second
- third
- 적용 예
- first
- second
- third
6. 링크(Link)
링크의 경우 다음과 같은 문법을 따른다.
6-1. 방법 1
[Title](link)
[클릭 해주세요](http://naver.com)
- 적용 예
6-2. 방법 2
<link>
링크 : <http://naver.com/>
- 적용 예
링크 : http://naver.com/
7. 이미지(Image)
7-1. 마크다운 문법 사용(Use the markdown)
Image삽입은 아래의 문법을 따른다.
![title](url)
![image url](https://i1.sndcdn.com/avatars-000639959556-jhitcq-t500x500.jpg)
- 적용 예
- markdown 문법에서는 이미지 크기 조절이 어렵다.
7-2. html 문법 사용(Use the html)
html 문법을 사용하면 markdown에서 이미지 크기 조절을 쉽게 할 수 있다.
<img src="link" width="size" height="size" />
<img src="https://i1.sndcdn.com/avatars-000639959556-jhitcq-t500x500.jpg" width="200" height="200" />
- 적용 예
8.표(Table)
8-1. 표 만들기(Create table)
Markdown에서 표를 만들기 위해서는 다음의 문법을 따른다.
| 를 표의 외곽이라 이해하면 된다.
|Hader|Description|Description2|
|--|--|--|
|cell1|cell2|cell3|
|cell2|cell2|cell3|
- 적용 예
Hader | Description | Description2 |
---|---|---|
cell1 | cell2 | cell3 |
cell2 | cell2 | cell3 |
8-2 문자 정렬 (Text Alignment)
좌로 정렬(left Alignment)
|Hader|Description|
|:--|:--|
|cell1|cell2|
|cell2|cell2|
- 적용 예
Hader | Description |
---|---|
cell1 | cell2 |
cell2 | cell2 |
우로 정렬(right Alignment)
|Hader|Description|
|--:|--:|
|cell1|cell2|
|cell2|cell2|
- 적용 예
Hader | Description |
---|---|
cell1 | cell2 |
cell2 | cell2 |
중앙 정렬(mid Alignment)
|Hader|Description|
|:--:|:--:|
|cell1|cell2|
|cell2|cell2|
- 적용 예
Hader | Description |
---|---|
cell1 | cell2 |
cell2 | cell2 |
9. 코드(Code)
9-1. 코드 블럭 사용하기.
코드 블럭은 원하는 코드의 위 아래에 백틱키를 3번 사용한다.
코드의 위 아래에(```)를 감싸준다.
```python
pip install os
print("hello world")
```
- 윗 부분 (```)사용 언어를 설정 해주면 각각의 환경에 따라 문법 강조가 가능하다.
- 적용 예(python 문법으로 작성)
pip install os
print("hello world")
9-2. 코드 강조하기
> 강조하고 싶은 문자 양옆을 `백틱`으로 감싼다.
- 적용 예강조하고 싶은 문자 양옆을
백틱
으로 감싼다.
10. 줄 바꿈
10-1. 단순 enter만 사용할 경우
일반적인 방식 대로 문장을 작성했습니다.
줄 바꿈이 적용된 것 처럼 보이지만 markdown 에서는 다음과 같이 보입니다.
- 적용 예
일반적인 방식 대로 문장을 작성했습니다. 줄 바꿈이 적용된 것 처럼 보이지만 markdown 에서는 다음과 같이 보입니다.
10-2. 줄 바꿈 방법
enter 기능을 사용하기 위해서는 모든 문장 뒤에 띄어쓰기를 2번 사용합니다.
이런 식으로 말이죠.
윗 문장들의 . 뒤에는 띄어쓰기가 2번 들어갔습니다.
- 적용 예
enter 기능을 사용하기 위해서는 모든 문장 뒤에 띄어쓰기를 2번 사용합니다.
이런 식으로 말이죠.
윗 문장들의 . 뒤에는 띄어쓰기가 2번 들어갔습니다.