마크다운(Markdown) 사용법을 알아보자

블로그를 hexo로 옮기게 되면서 가장 처음 접한 문제는 github 그리고 마크다운이었다.
세팅은 여차저차 했지만 글 작성에서부터 막히기 시작했다.
나와 같은 사람들을 위해 쉽게 마크다운 사용법을 정리해 보았다.

먼저 간단하게 마크다운에 대해 알아보고 넘아가겠습니다.

마크다운(Markdown)


마크다운(Markdown)은 일반 텍스트 문서의 양식을 편집하는 문법이다.
README 파일이나 온라인 문서, 혹은 일반 텍스트 편집기로 문서 양식을 편집할 때 쓰인다.
마크다운을 이용해 작성된 문서는 쉽게 HTML 등 다른 문서 형태로 변환이 가능하다.위키백과

마크다운의 장점과 단점


장점

  1. 문법이 쉽고 간결합니다.
  2. 별도의 도구가 필요없다.
  3. 지원하는 플랫폼과 프로그램이 다양하다.
  4. 다양한 형태로 변환이 가능하다.

단점

  1. 표준이 없고 그로인해 사용자마다 문법이 다르다.
  2. 모든 HTML 마크업을 대신 할 수 없다.


마크다운 문법(Syntax)


제목 (Header)

HTML의 <h1>부터 <h6>으로 변환되며 제목을 표현할 때 사용합니다.

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

수평선 (Horizontal rule)

HTML의 <hr> 태그로 변환됩니다.
수평선을 표시하는 방법은 여러가지가 있다.
각 기호를 3번 이상 입력하는 방법으로 사용한다.

.md
1
2
3
--- (Hyphens)
*** (Asterisks)
___ (Underscores)

인용문구 (Blockquote)

HTML의 <blockquote> 태그로 변환됩니다.
중첩해서 사용이 가능합니다.
인용안에서 마크다운 문법을 사용할 수 있습니다.

.md
1
2
3
> 안용문구를 나타낼때 사용합니다.
>> 중첩해서 사용이 가능합니다.
>>> ## 인용의 인용

인용구문을 나타낼때 사용합니다.

중첩해서 사용이 가능합니다.

인용의 인용

목록 (List)

HTML의 <ol>,<ul>,<li> 태그로 변환됩니다.

순서있는 목록 (ol)

순서있는 목록은 숫자와 점을 사용합니다.

.md
1
2
3
1. 첫번째
2. 두번째
3. 세번째

*특이한 점은 어떤 번호를 입력해도 순서는 내림차순으로 정의가 된다.

순서없는 목록 (ul)

.md
1
2
3
- 대쉬 (hyphen)
* 별표 (asterisks)
+ 더하기 (plus sign)

강조 (Emphasis)

HTML의 <em>, <strong>, <del> 태그로 변환됩니다.
밑줄<u></u> 태그를 사용하시면 됩니다.

1
2
3
4
이텔릭체: *텍스트* 또는 _텍스트_ 를 사용
두껍게: **텍스트** 또는 __텍스트__ 를 사용
취소선: ~~텍스트~~ 를 사용
<u>밑줄</u> 은 <u></u> 태그를 사용

HTML의 <a> 태그로 변환됩니다.

.md
1
2
3
4
5
6
[링크](링크주소)
[링크](링크주소 "링크설명- 생략가능")

문서안에서 [참조링크] 사용가능합니다.
[참조링크노출설명][참조링크] 의 형태로 사용
[참조링크]: 참조링크주소 "링크설명 - 생략가능"

이미지

HTML의 <img> 태그로 변환됩니다.
링크와 비슷하지만 앞에 !가 붙습니다.

.md
1
![대체텍스트](링크 "링크설명")

이미지에 링크

마크다운 이미지코드를 링크 코드로 묶어 줍니다.

.md
1
[![대체텍스트](링크 "링크설명")](링크주소)

HTML 코드

마크다운 문법 뿐 아니라 원시 HTML문법을 사용할 수 있습니다.

이상으로 마크다운 문법에 대해서 알아보았는데요 쉬운 면이 있으면서도
처음 접하는 거라 그런지 낯선부분들도 있습니다.
쓰다 보면 차차 익숙해지겠죠 ㅎㅎ

궁금하신 점이나 잘못된점은 언제든 댓글로 남겨주시면 감사하겠습니다.

댓글

Your browser is out-of-date!

Update your browser to view this website correctly. Update my browser now

×