ToolsGit

[Markdown] Syntax

,

Markdown Syntax

마크다운 (Markdown)은 마크업 언어의 일종으로, 존 그루버(John Gruber)와 아론 스워츠(Aaron Swartz)가 만들었다. 읽기도 쓰기도 쉽다는 장점이 있다. 그루버는 마크다운으로 작성한 문서를 HTML로 변환하는 펄 스크립트도 만들었다. 확장자는 .md를 쓴다.

문단 제목
문단 제목은 다음과 같이 표현한다.

1
2
3
# 큰 제목
## 중간 제목
### 작은 제목

또는, 큰 제목과 중간 제목은 다음과 같은 문법도 사용가능하다.

1
2
3
4
5
큰 제목
====================

중간 제목
---------------------

문단
줄바꿈을 두 번 하면 된다.

1
2
3
하나의 문단.

다른 문단.

목록
순서가 부여된 리스트

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

전부 다 같은 숫자를 넣어도 순서가 제대로 부여된다.

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

순서없는 리스트는 다음과 같은 문법을 사용한다.

1
2
3
- 첫 번째
- 두 번째
- 세 번째

또는,

1
2
3
* 첫 번째
* 두 번째
* 세 번째

이탤릭체

1
*이탤릭체*

또는,

1
_이탤릭체_

볼드체

1
**볼드체**

또는,

1
__볼드체__

취소선

1
~~취소선~~

인용문

1
> 인용문

링크

1
[텍스트](http://url)

또는, 다음과 같이 써서 참조링크를 쓸 수 있다.

1
2
출처는 [텍스트][link]입니다.
[link]: url "툴팁 메세지 표기 생략가능"

또는, 다음과 같이 써서 자동연결링크를 쓸 수 있다.

1
2
<http://example.com/>
<address@example.com/>

테이블

1
2
3
4
| 헤더1 | 헤더2 | 헤더3 |
| ----- | ----- | ----- |
| 내용1 | 내용2 | 내용3 |
| 내용1 | 내용2 | 내용3 |

마크다운 테이블 자동생성

코드

1
`code`

이미지

1
![alt text](이미지.png "툴팁 메시지 표기 생략가능")

또는, 다음과 같이 써서 주석형태로 그림을 넣을 수 있다.

1
2
![alt text][link]
[link]: 이미지.png "툴팁 메시지 표기 생략가능"

가로줄

1
2
3
4
5
* * *
***
*****
- - -
------------

Github-Flavored Markdown

github에서 쓰이며 다음과 같은 차이점이 있다.

  • 줄바꿈을 한번만 해도 강제개행을 할 수 있다.
  • do_this_and_do_that과 같은 형태의 단어를 기울임꼴 글자로 처리하지 않는다.
  • URL을 자동으로 링크로 변환해준다.
  • 코드를 입력할 때 ``` 로 감싸주는 문법이 추가되었다.
  • 문법 강조가 적용이 된다. Linguist를 이용하여 처리한다.
  • 작업 목록(Task lists) 문법이 추가되었다.
  • Git관련 링크를 자동으로 처리해준다. (SHA, 사용자, 이슈 등)

참조

공유하기