Markdown 가이드
Markdown
우리가 정보를 찾을때 블로그를 많이 참고하는 것처럼
지식 공유 목적을 위해 개인 사이트를 많이 사용합니다.
많은 개발자들도 지식들을 공유하기 위함으로 github을 사용합니다.
하지만, github의 블로그는 굉장히 불친절합니다.
글을 올리기 위해서 처음부터 끝까지 모두 지정해 줘야하죠.
이런 웹페이지를 구성에 필요한 것이 HTML 입니다.
HTML( Hyper Text Markup Language) : 웹페이지를 만들기 위해 사용하는 언어
HT(Hyper Text) : 문서와 문서를 연결 해주는 링크
M(Markup) : 태그
L(Language) : 언어(흔히 말하는 프로그래밍 언어)
글을 쓸 때에도 모든 태그들을 일일히 지정하기엔 굉장히 번거롭습니다.
글을 간편하게 작성할 수 있도록 도와준 것이
바로 Markdown 입니다.
Markdown 이란 간단한 텍스트를 이용해 HTML변환을 해주는 문법입니다.
Markdown 문법
1. Header
제목이나 소제목을 나타낼 때 사용하는 문법입니다.
#을이용하여 나타냅니다.
총 6개의 #을 이용하여 나타낼 수 있으며, 7개 이상일 시 문자로 표기 됩니다.
# H1 태그
## H2 태그
### H3 태그
#### H4 태그
##### H5 태그
###### H6 태그
####### H7 태그
또는
H1 태그
===
H2 태그
---
=== : H1 태그(글 밑에 ===)
--- : H2 태그(글 밑에 ---)
--- 만 사용할 경우 다른 의미가 됩니다. 이는 아래서 설명하도록 하겠습니다.
위와 같이 #7개는 지원하지 않습니다.
2. 강조와 취소선
1. 강조
강조에는 세 가지의 종류가 있습니다.
- 첫번째로, 이탤릭체
- 두번째로, 볼드체
- 세번쨰로, 이탤릭체 + 볼드체
_이탤릭체_ 또는 *이탤릭체* : '_' 하나 / '*' 하나
__볼드체__ 또는 **볼드체** : '_' 둘 / '*' 둘
*__이탤릭체 + 볼드체__* 또는
___이탤릭체 + 볼드체___ 또는
**_이탤릭체 + 볼드체_** 또는
_**이탤릭체 + 볼드체**_ : 위의 조합을 이용한 모든 경우의 수로 사용 가능합니다.
이탤릭체
볼드체
이탤릭체 + 볼드체
2. 취소선
주로 실수한 문제 또는 제거할 문자를 표현할 때 사용합니다.
~~취소선~~~
취소선
3. 수평선
수평선은 글을 나눠줄 필요가 있을때 사용합니다.
글머리에 간단한 소개를 하고 아래 본문으로 들어갈 때,
글의 전환이 필요할 때
등등 사용합니다.
3개 이상을 작성해도 3개와 동일한 효과를 냅니다.
***
---
___
* * *
- - -
_ _ _
4. 인용문
인용문은 다른 사람의 말을 직접 또는 간접적으로 가져와 쓸 경우 사용합니다.
>를 이용하여 인용문을 사용할 수 있습니다.
> 인용문1
>> 인용문2
>>> 인용문3
재인용은 많이 사용할 수 있지만,
그만큼 지저분해지고 알아보기 힘들기에 적당한 양만 사용하길 권장합니다.
인용문1
인용문2
인용문3
5. 목록
1. 순서가 존재하는 목록
숫자를 작성해 주면 됩니다.
1. 순서1
2. 순서2
3. 순서3
만약 이 아래
2. 순서4
를 적었을 경우 숫자 2.를 4.로 자동으로 변경해줍니다.
번호는 할당된 숫자에 따라 유동적으로 변화합니다.
- 순서1
- 순서2
- 순서3
- 순서4
2. 순서가 존재하지 않는 목록
사용할 수 있는 기호는 세 가지 입니다.
-,+,*
- : 검은 동그라미
- : 빈 동그라미
- : 검은 네모
- : 검은 네모
처음 세 개 만 모양이 다르고 네번쨰 이후엔 검은 네모로 동일합니다.
또한, 세 가지의 종류를 혼합하여 사용할 수 있습니다.
*
+
-
- 사람
- 얼굴
- 눈
- 망막
- 시신경
- 망막
- 눈
- 얼굴
6. 코드
1. 코드 블럭
1-1. 들여쓰기
한 줄 작성 후 엔터키를 사용하여 줄바꿈을 하고,
들여쓰기를 하면 자동으로 코드 블럭이 만들어 집니다.
코드 블럭을 마치고 싶을 시에는
들여쓰지 않는 문장을 아래에 작성해 주면 됩니다.
안녕하세요.
* 여기는 엔터 꼭 필요!!
Hoduire의 블로그 입니다.
* 엔터 꼭 필요!!
반갑습니다.
코드 블럭 문장 바로 위, 아래는 엔터키를 꼭 해주셔야 합니다.
안녕하세요.
Hoduire의 블로그 입니다.
반갑습니다.
엔터를 사용하지 않고 작성할 경우
안녕하세요.
Hoduire의 블로그 입니다.
반갑습니다.
안녕하세요.
Hodurie의 블로그 입니다.
반갑습니다.
이 문장을 작성 한 것과 동일하게 나타납니다.
안녕하세요.
Hoduire의 블로그 입니다.
반갑습니다.
안녕하세요.
Hodurie의 블로그 입니다.
반갑습니다.
표시되는 문장이 조금 다를 수 있는데,
이는 Markdown에서 줄바꿈(엔터)가 적용되지 않습니다.(엔터 두번은 여백 포함 줄바꿈)
강제적으로 줄바꿈을 하기 위해서는
스페이스바 두 번을 문장 끝에 넣어주시면 되겠습니다.
1-2. ``` 사용하기
``` 를 이용하여 직접 나타낼 수 있습니다.
여기서
```는 작은 따음표가 아닌 숫자 1 옆에 있는 기호입니다.
``` <- 코드를 작성하기전 열어 줍니다.
코드를 작성하는 공간입니다.
``` <- 작성한 후 한번 더 입력하여 닫아줍니다.
특정 프로그램 언어로 표현하는 방법이 있습니다.
```python
print('code')
```
바로 처음 ``` 옆에 프로그램 언어를 작성해 주면 됩니다.
print('code')
2. 코드 삽입
하나의 글자에만 코드를 삽입하고 싶을 수 있습니다.
이럴 경우에는 글자 양옆에 `를 붙여 주시면 됩니다.
안녕하세요. `hoduire`의 블로그 입니다.
안녕하세요. hoduire의 블로그 입니다.
7. 링크
참고 문헌/문서를 표현할 때, 이미지를 출력할 때 사용하는 방법입니다.
* 하이퍼 링크의 경우
[링크에 대한 간단한 설명](페이지 주소)
* 실제 링크를 보여주고 싶을 때
링크 : <페이지 주소>
* 이미지 링크의 경우
Hodurie 블로그
Hodurie 블로그 : https://hodurie.gitub.io
8. 테이블 만들기
컬럼과 그에 해당하는 값들을 넣고 싶을 때,
우리는 주로 테이블을 만들어 확인합니다.
| | | : 제일 처음(column 지정)
|-|-| : 테이블임을 암시(-는 3개 이상 사용)
| | | : 각 column에 해당하는 값을 을 적는 곳
|는 shift + \(backspcae바 아래) 키 입니다.
맨 오른쪽 또는 맨 왼쪽의 |기호는 생략 가능 합니다.
둘 다 생략해도 괜찮습니다.
제목|내용
----|---
markdown|문법
글자를 정렬 하고 싶을 경우
id|이름|내용
----:|:---|:---: <- :의 위치에 따라 정렬이 달라짐
123|hodurie|블로그 주인
:를 어디에 붙이냐에 따라 정렬이 달라집니다.
: 맨 왼쪽 : 왼쪽 정렬
: 맨 오른쪽 : 오른쪽 정렬
: 양쪽 : 양쪽 정렬
또는 강조하고 싶을 경우
학번|전공|부전공
----|---|---
*1*|__심리학과__|_**통계학과**_
위에서 사용한 강조 문법을 셀 안에 넣어서 표현하면 됩니다.
| 제목 | 내용 |
|---|---|
| markdown | 문법 |
| id | 이름 | 내용 |
|---|---|---|
| 123 | hodurie | 블로그 주인 |
| 학번 | 전공 | 부전공 |
|---|---|---|
| 1 | 심리학과 | 통계학과 |
정리
Markdown은 간단한 문법으로 HTML을 나타내는 방법입니다.
이를 익히면 좀 더 간편하고 편리하게 글을 작성 할 수 있습니다.
하지만, 글을 예쁘고 아름답게 표현하기 위해선
어느정도의 HTML과 CSS에 대해 알아야 합니다.
마치며
Markdown을 활용하기 위해 정리 겸 공부 겸 글을 올렸습니다.
제가 다 이해하지 못해 생략한 부분도 있습니다.
이를 보충하기 위해선 원문의 글을 읽어보는 것도 좋을 것 같습니다.
또, 이런 부족함을 채우기 위해 열심히 공부해야 겠다는 다짐을 하고 갑니다.
긴 글이지만 끝까지 읽어주셔서 감사합니다.
Reference
HTML
Markdown
- ihoneymon님의 [공통] 마크다운 markdown 작성법
- BigBio님의 마크다운 문법 (Markdown)
댓글남기기