Markdown으로 문서를 작성하는 방법

Markdown

“

Markdown은 2004년 존 그루버(John Gruber)가 만든 경량 마크업 언어로, 읽고 쓰기 쉬운 일반 텍스트 형식으로 문서를 작성할 수 있게 해 줍니다.
변환 도구를 사용하면 Markdown 문서를 HTML, Word, 이미지, PDF, EPUB 등 다양한 형식으로 내보낼 수 있습니다.
Markdown 문서의 확장자는 보통 .md 또는 .markdown입니다.

Markdown 활용

GitBook 같은 도구를 사용하면 Markdown으로 전자책을 작성할 수도 있습니다.

GitHub, Jianshu, Reddit, Diaspora, Stack Exchange, OpenStreetMap, SourceForge 등 많은 웹사이트가 도움말 문서나 포럼 게시물에 Markdown을 사용합니다.

Markdown 기본 문법

제목 | Title

Markdown 제목에는 두 가지 형식이 있습니다.

1. =와 -로 1단계와 2단계 제목 만들기

这是H1的标题
===========

这是H2的标题
-----------

2. #로 제목 만들기

행 앞의 # 개수로 1~6단계 제목을 나타냅니다. 1단계에는 # 하나, 2단계에는 # 두 개를 사용하며, 같은 방식으로 이어집니다.

# 一级标题

## 二级标题

### 三级标题

#### 四级标题

##### 五级标题

###### 六级标题

문단 | Paragraph

문단에는 특별한 문법이 필요하지 않습니다. 그대로 글을 쓰면 됩니다. 문단 안에서 줄을 바꾸려면 줄 끝에 공백을 두 개 이상 넣고 Enter 키를 누릅니다.

문단 사이에 빈 줄을 하나 넣으면 새 문단이 됩니다.

기울임꼴과 굵게 | Phrase Emphasis

Markdown에서 *텍스트* 또는 _텍스트_는 기울임꼴을, **텍스트** 또는 __텍스트__는 굵은 글씨를 나타냅니다.

목록 | List

Markdown은 순서 없는 목록과 순서 있는 목록을 지원합니다.

순서 없는 목록

순서 없는 목록은 별표 *, 더하기 기호 + 또는 빼기 기호 -를 목록 표시로 사용합니다. 표시 뒤에 공백을 하나 넣은 다음 항목 내용을 작성합니다:

* 第一项
* 第二项
* 第三项

+ 第一项
+ 第二项
+ 第三项

- 第一项
- 第二项
- 第三项

순서 있는 목록

순서 있는 목록은 숫자에 . 기호를 붙여 나타냅니다. 예:

1. 第一项
2. 第二项
3. 第三项

목록 중첩

목록 중첩은 하위 목록의 항목 앞에 공백 네 개를 추가하기만 하면 됩니다:

1. 第一项：
    - 第一项嵌套的第一个元素
    - 第一项嵌套的第二个元素
2. 第二项：
    - 第二项嵌套的第一个元素
    - 第二项嵌套的第二个元素

블록 인용 | Blockquotes

문단 맨 앞에 >를 쓰고 바로 뒤에 공백을 하나 넣으면 블록 인용이 됩니다:

>Hi, this is xxxbrian.
>Brian's Blog
>等青春轻飘的烟雾把少年的欢乐袅袅曳去，之后，我们就能取得一切值得吸取的东西。 ——普希金

블록 인용은 중첩할 수 있습니다. > 하나는 가장 바깥쪽 인용, 두 개의 >는 첫 번째 중첩 단계를 나타냅니다. 같은 방식으로 더 깊게 중첩할 수 있습니다:

> 最外层
> > 第一层嵌套
> > > 第二层嵌套

블록 안에서 목록 사용

> 区块中使用列表
> 1. 第一项
> 2. 第二项
> + 第一项
> + 第二项
> + 第三项

목록 안에서 블록 사용

+ 第一项
    > Brian's Blog
    > Hi, this is xxxbrian.
+ 第二项

코드 | Code

문단 안의 함수명이나 코드 조각은 백틱`으로 감쌉니다. 예를 들어 `코드`처럼 씁니다. 다음은 함수명 printf()를 표시하는 예입니다.

`printf()`函数

코드 블록

코드 블록은 각 줄의 맨 앞에 공백 4개 또는 탭 문자(Tab 키) 하나를 넣어 작성합니다.

$(document).ready(function () {
    alert('RUNOOB');
});

표시 결과는 다음과 같습니다:

$(document).ready(function () {
alert('RUNOOB');
});

코드 블록 앞뒤를 ```으로 감싸는 방법도 있습니다. 여는 표식 뒤에 언어 이름을 넣을 수 있으며, 생략해도 됩니다:

$(document).ready(function () {
    alert('RUNOOB');
});

표시 결과는 다음과 같습니다:

$(document).ready(function () {
    alert('RUNOOB');
});

하이퍼링크 | Link

링크 사용 방법은 다음과 같습니다:

[链接名称](链接地址)

或者

<链接地址>

예:

这是一个链接 [Brian's Blog](https://xxxbrian.me)

링크 예: Brian's Blog

링크 주소 직접 사용

链接 <https://xxxbrian.me>

링크 <https://xxxbrian.me>

참조형 링크

참조형 링크는 본문에서 레이블로 링크를 참조하고, 해당 URL을 문서 끝 등에 따로 정의하는 방식입니다:

这个链接用 1 作为网址变量 [Google][1]
这个链接用 Brian's Blog 作为网址变量 [xxxbrian][xxxbrian]

[1]: http://www.google.com/
[xxxbrian]: https://xxxbrian.me

이미지 | Images

Markdown 이미지 문법 형식은 다음과 같습니다:

![alt 属性文本](图片地址)

![alt 属性文本](图片地址 "可选标题")

• 맨 앞에 느낌표 !
• 다음 대괄호 한 쌍 안에 이미지의 대체 텍스트를 넣습니다.
• 이어서 소괄호 한 쌍 안에 이미지 URL을 넣습니다. 선택적으로 URL 뒤에 따옴표로 감싼 'title' 텍스트를 덧붙일 수 있습니다.

사용 예:

![xxxbrian 图标](https://raw.githubusercontent.com/xxxbrian/xxxbrian.github.io/master/img/xxxbrian-192x192.png "xxxbrian")

표 | Tables

Markdown에서 표를 만들 때는 | 기호로 서로 다른 셀을 구분하고, - 기호로 표 머리글과 다른 행을 구분합니다.

|  表头   | 表头  |
|  ----  | ----  |
| 单元格  | 单元格 |
| 单元格  | 单元格 |

표 정렬

• -: 내용과 머리글을 오른쪽 정렬합니다.
• :- 내용과 머리글을 왼쪽 정렬합니다.
• :-: 내용과 머리글을 가운데 정렬합니다.

| 左对齐 | 右对齐 | 居中对齐 |
| :-----| ----: | :----: |
| 单元格 | 单元格 | 单元格 |
| 单元格 | 单元格 | 单元格 |

이스케이프 | Backslash Escapes

Markdown은 특정 의미를 나타내기 위해 많은 특수 기호를 사용합니다. 특정 기호를 표시해야 할 때는 이스케이프 문자가 필요하며, Markdown에서는 백슬래시로 특수 문자를 이스케이프합니다:

**文本加粗** 
\*\* 正常显示星号 \*\*

다음 기호 앞에 백슬래시를 붙이면 그 기호를 일반 문자로 표시할 수 있습니다:

\   反斜线
`   反引号
*   星号
_   下划线
{}  花括号
[]  方括号
()  小括号
#   井字号
+   加号
-   减号
.   英文句点
!   感叹号