광범위하게 적용되고 있는 마크다운 사용방법입니다. 현재 github, 티스토리, jupyter python에서 쓰고 있어서 정리도 할겸 공유합니다. 참고로 마크다운이 html 모든 것을 대체할 수는 없습니다.
대신에 마크다운 내에서 html이 작동하니 해결이 안 되는 부분은 html로 작성하면 됩니다. CSS로 얼마든지 꾸미기가 가능하니 문법의 의미로써만 받아들이시길 바랍니다.
마크다운 사용방법
목차
제목넣기
큰제목
Title =============
Title
작은 제목: 부제목
SubTitle -------------
SubTitle
- 글씨크기변경 H1 = 큰제목 H2 = 작은 제목 H1~H6까지 있습니다.
# H1
## H2
### H3
#### H4
##### H5
###### H6
H1
H2
H3
H4
H5
H6
인용블록
’>’를 이용해 인용구를 넣습니다.
> Blockquote
> >Blockquote
> > >Blockquote
Blockquote
Blockquote
Blockquote
목록 넣기
글머리 기호는 *,+,- 이 가능합니다. 뭘 해도 똑같은 모양이고 섞어써도 됩니다. 기호 옆에 바로 쓰면 글머리가 적용되지 않습니다. 띄어쓰기를 한칸 해주어야 합니다.
* A
* B
* C
+ A
+ B
+ C
- A
- B
- C
A
- B
- C
- B
A
- B
- C
- B
A
- B
- C
- B
번호 매기기
번호 매기기도 글머리와 같은 방식입니다. 번호를 매기고 글머리로 바꾸어도 적용됩니다.
1
2
3
1. A
2. B
3. C
- A
- B
- C
번호의 번호, 글머리 모두 가능합니다.
- A
- a
- b
- a
코드블록
코드블록을 넣는 방법에는 2가지 방법이 있습니다. 첫번째는 html을 이용한 방법입니다. class에 원하는 언어를 넣어서 문법강조를 할 수 있습니다.
1
<pre><code class='lang'>print('hello world')</code></pre>
print('hello world')1
2
3
4
5
6
7
8
9
10
11
두번째 방법은( "\`\`\`") 를 사용하는 방법입니다.
("\`\`\`") 이후 사용언어를 넣어 문법강조를 할 수 있습니다.
\`\`\`python
print('hello world')
\`\`\`
```python
print('hello world')
링크 넣기
- 참조링크 참조링크는 글의 맨 밑에 링크를 넣어두어서 하는 방법으로 주로 쓰이는데 마크다운에서도 가능합니다.
링크정의를 이용하는 방법
먼저 내가 쓴 문구를 하이퍼링크로 만드는 방법입니다. 아래와 같이 형식이 있습니다. 예로 구글을 링크로 넣어보겠습니다.
[Google][link]
[link]: https://www.google.com
link 정의를 해줌으로써 글자에 자연스럽게 연결이 됩니다. 주의할 것은 콜론을 반드시 정의옆에 붙여놔야 작동됩니다.
url 바로 붙이기
link 정의를 따로 하는것이 불편하다면 바로 url을 써서 적용할 수 있습니다.
1
[Google](https://www.google.com)
#### 링크 설명넣기 링크에 마우스를 갖다대면 링크설명이 나오게 할 수도 있습니다.
1
[Google](https://www.google.com, "구글 홈페이지~!")
정의 안하고 설명넣어 링크만들기
두가지 기능을 합쳐서 하면 간편합니다. 즉, 진짜 제대로된 참조링크가 됩니다.
1
2
3
4
[Google]
[Google]: https://www.google.com "구글로 이동합니다."
실제 url 넣기
실제 url 주소만 넣고 싶다면 <>괄호 안에 url을 직접 작성합니다.
1
구글 홈페이지 : <htttps://www.google.com>
구글 홈페이지 : <htttps://www.google.com>
- 내부링크 문서 내부 링크하는 방법입니다.목차나 바로가기를 할 수 있습니다.
주의할점- 띄어쓰기는 - 표시로 해야한다.
- 링크대상은 헤더(h1,h2)만 가능
- 영어는 모두 소문자로 작성
1
[이름](#이동할-위치)
위의 링크를 누르면 목차으로 이동합니다.
접기
문서 접기가 가능합니다. 클릭을 하면 문서가 나오는 형식입니다.
1
2
3
<details><summary>접기</summary>
Hello world
</details>
접기
Hello world이미지 넣기
이미지는 다음과 같이 넣습니다. 대괄호에 대체텍스트를 소괄호에는 그림경로를 입력합니다.
1
이미지에 링크넣기
1
[](url주소)
그림을 누르면 R 홈페이지로 넘어가도록 해보겠습니다. 
표 만들기
마크다운으로 간단한 표를 만들 수 있습니다. 복잡한 표를 만들려면 html로 만드는걸 추천합니다.
1
2
3
4
5
|col1|col2|col3| # 헤더셀
|----:|----:|----:| # 헤더셀 구분, 콜론은 셀(열/칸) 정렬
|A|a|에이|
|B|b|비|
|C|c|씨|
| col1 | col2 | col3 |
|---|---|---|
| A | a | 에이 |
| B | b | 비 |
| C | c | 씨 |
이스케이프
마크다운 기호를 문자로 쓰고 싶으면 해당 문자 앞에 \ 문자를 넣어서 회피합니다.
1
\*,\_,\+ 이 가능합니다.
*,_,+ 이 가능합니다.
수평선
*,-._ 중 아무거나 택해서 3개이상 입력합니다.
(수평선)
줄바꿈
줄바꿈은 2번 띄어쓰기를 하거나 html에서
을 가져와 사용합니다. 그런데 2번 띄어쓰기가 안 되는 환경도 있으므로
을 활용하는게 좋습니다.
1
2
ABCD<br>
abcd
ABCD
abcd
글씨 강조
1
2
3
4
이텔릭체: *이텔릭체* or _이텔릭체_
굵은글씨: **굵은글씨** or __굵은글씨__
취소선 : ~~취소선~~
밑줄 : <u>밑줄</u>
이텔릭체: 이텔릭체 or 이텔릭체 굵은글씨: 굵은글씨 or 굵은글씨 취소선 : 취소선 밑줄 : 밑줄
마치며
많이 쓰는 마크다운 위주로 정리를 했습니다. 마크다운은 광범위하게 쓰이고 있어서 알아두면 좋습니다. 그런데 세세하게 들어가면 쓸만한 문법이 더 있는 것 같은데 간편함으로 쓰는 용도라 굳이 더 알아야 하나 라는 생각이 드네요.