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

2021년 5월 19일 수요일 / ,
简体中文한국어

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단계 제목 만들기

Markdown
H1 제목입니다
===========

H2 제목입니다
-----------
markdown_title1.png

2. #로 제목 만들기

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

Markdown
# 1단계 제목

## 2단계 제목

### 3단계 제목

#### 4단계 제목

##### 5단계 제목

###### 6단계 제목
markdown_title2.png

문단 | Paragraph

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

markdown_paragraph1.png

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

markdown_paragraph2.png

기울임꼴과 굵게 | Phrase Emphasis

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

사용법

결과

*기울임꼴 텍스트*

기울임꼴 텍스트

_기울임꼴 텍스트_

기울임꼴 텍스트

**굵은 텍스트**

굵은 텍스트

__굵은 텍스트__

굵은 텍스트

***굵은 기울임꼴 텍스트***

굵은 기울임꼴 텍스트

___굵은 기울임꼴 텍스트___

굵은 기울임꼴 텍스트


목록 | List

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

순서 없는 목록

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

Markdown
* 첫 번째 항목
* 두 번째 항목
* 세 번째 항목

+ 첫 번째 항목
+ 두 번째 항목
+ 세 번째 항목

- 첫 번째 항목
- 두 번째 항목
- 세 번째 항목
markdown_list1.png

순서 있는 목록

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

Markdown
1. 첫 번째 항목
2. 두 번째 항목
3. 세 번째 항목
markdown_list2.png

목록 중첩

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

Markdown
1. 첫 번째 항목:
    - 첫 번째 항목에 중첩된 첫 번째 요소
    - 첫 번째 항목에 중첩된 두 번째 요소
2. 두 번째 항목:
    - 두 번째 항목에 중첩된 첫 번째 요소
    - 두 번째 항목에 중첩된 두 번째 요소
markdown_list3.png

블록 인용 | Blockquotes

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

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

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

Markdown
> 가장 바깥쪽
> > 첫 번째 중첩 단계
> > > 두 번째 중첩 단계

블록 안에서 목록 사용

Markdown
> 인용 블록 안에서 목록 사용
> 1. 첫 번째 항목
> 2. 두 번째 항목
> + 첫 번째 항목
> + 두 번째 항목
> + 세 번째 항목

목록 안에서 블록 사용

Markdown
+ 첫 번째 항목
    > Brian's Blog
    > Hi, this is xxxbrian.
+ 두 번째 항목
markdown_blockquotes.png

코드 | Code

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

Markdown
`printf()` 함수

코드 블록

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

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

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

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

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

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

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

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

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

Markdown
[링크 텍스트](링크주소)

또는

<링크주소>

예:

Markdown
다음은 링크입니다 [Brian's Blog](https://xxxbrian.me)

링크 예: Brian's Blog

링크 주소 직접 사용

Markdown
링크 <https://xxxbrian.me>

링크 <https://xxxbrian.me>

참조형 링크

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

Markdown
이 링크는 1을 참조 레이블로 사용합니다 [Google][1]
이 링크는 Brian's Blog를 참조 레이블로 사용합니다 [xxxbrian][xxxbrian]

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

markdown_link.png

이미지 | Images

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

Markdown
![대체 텍스트](이미지주소)

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

사용 예:

Markdown
![xxxbrian 아이콘](https://raw.githubusercontent.com/xxxbrian/xxxbrian.github.io/master/img/xxxbrian-192x192.png "xxxbrian")

표 | Tables

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

Markdown
|  머리글   | 머리글  |
|  ----  | ----  |
| 셀  | 셀 |
| 셀  | 셀 |

표 정렬

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

이스케이프 | Backslash Escapes

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

Markdown
**굵은 텍스트** 
\*\* 별표를 그대로 표시 \*\*

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

TEXT
\   역슬래시
`   백틱
*   별표
_   밑줄
{}  중괄호
[]  대괄호
()  소괄호
#   해시 기호
+   더하기 기호
-   빼기 기호
.   마침표
!   느낌표
  • Loading...
  • Loading...
  • Loading...
  • Loading...
  • Loading...