Markdown 문법 가이드

일상적으로 쓰는 Markdown을 위한 한눈에 보는 치트 시트입니다. 각 블록은 문법과 결과를 함께 보여줍니다.

Markdown이란?

Markdown은 일반 텍스트에 서식을 더하는 가벼운 방법입니다. 버튼과 메뉴 대신, 제목을 나타내는 #이나 강조를 나타내는 * 같은 몇 가지 간단한 기호를 사용하며, 원본 텍스트 상태로도 읽기 쉽습니다.

2004년 John Gruber와 Aaron Swartz가 만들었으며, README, 문서, 메모, GitHub나 Reddit 같은 사이트의 표준이 되었습니다. 그저 텍스트이기 때문에, 작성한 글은 어디서나 이식성 있고 읽기 쉽게 유지됩니다.

이 가이드는 가장 자주 사용하는 문법을 다룹니다. 예제를 Markdown Peek에서 열고 스페이스 바를 눌러 원본과 렌더링된 결과를 전환해 보세요.

제목

줄 시작에 # 문자를 1개에서 6개까지 붙이세요. 더 많은 #은 더 작고 더 깊은 제목을 의미합니다.

Markdown

# Heading 1
## Heading 2
### Heading 3
#### Heading 4

결과

Heading 1

Heading 2

Heading 3

Heading 4

굵게, 기울임, 그 밖의 강조

텍스트를 기호로 감싸 강조하세요. 자유롭게 조합할 수 있습니다.

Markdown

**Bold text**
*Italic text*
***Bold and italic***
~~Strikethrough~~
`Inline code`

결과

Bold text

Italic text

Bold and italic

Strikethrough

Inline code

목록

글머리 기호에는 대시, 별표, 더하기 기호를, 순서 있는 목록에는 숫자를 사용하세요. 들여쓰기로 중첩할 수 있습니다.

Markdown

- First item
- Second item
  - Nested item
- Third item

1. Step one
2. Step two

결과

  • First item
  • Second item
    • Nested item
  • Third item
  1. Step one
  2. Step two

링크

대괄호 안에 표시할 텍스트를, 괄호 안에 주소를 넣으세요.

Markdown

[Markdown Peek](https://markdownpeek.com)
<https://markdownpeek.com>

이미지

이미지는 앞에 느낌표가 붙은 링크입니다. 대괄호 안의 텍스트는 대체 텍스트입니다.

Markdown

![A cat looking up](cat.jpg)

결과

A cat looking up

인용문

줄 시작에 >를 붙이면 인용됩니다. >를 하나 더 붙이면 인용 안에 인용을 중첩할 수 있습니다.

Markdown

> A quote worth remembering.
>
> > And a nested one.

결과

A quote worth remembering.

And a nested one.

코드

인라인 코드는 백틱 하나로, 코드 블록 전체는 백틱 세 개로 감싸고, 언어 이름을 선택적으로 붙일 수 있습니다.

Markdown

Use `backticks` for inline code.

```js
function hi() {
  console.log("Hello");
}
```

결과

Use backticks for inline code.

function hi() {
  console.log("Hello");
}

표

열은 파이프로 구분하고, 헤더 행 아래에는 대시로 밑줄을 그으세요. 콜론으로 정렬을 설정합니다.

Markdown

| Feature | Supported |
|---------|:---------:|
| Tables  | Yes       |
| Code    | Yes       |

결과

FeatureSupported
TablesYes
CodeYes

구분선

대시, 별표, 밑줄을 세 개 이상 한 줄에 단독으로 쓰면 구분선이 그려집니다.

Markdown

Above the line.

---

Below the line.

결과

Above the line.


Below the line.

할 일 목록

[ ]가 있는 목록 항목은 미완료 작업, [x]는 완료된 작업입니다.

Markdown

- [x] Read the guide
- [ ] Set as default app

결과

  • Read the guide
  • Set as default app

특수문자 이스케이프

기호 앞에 백슬래시를 붙이면 서식이 아니라 그 문자 그대로 표시됩니다.

Markdown

\*Not italic\*
\# Not a heading

결과

*Not italic*

# Not a heading

LaTeX 수식

문장 안의 수식은 달러 기호 하나로, 독립된 줄의 수식은 달러 기호 두 개로 감싸세요. Markdown Peek은 둘 다 오프라인으로 렌더링합니다.

Markdown

Inline math like $E = mc^2$ works in a sentence.

$$
a^2 + b^2 = c^2
$$

결과

Inline math like E = mc2 works in a sentence.

a2 + b2 = c2

Mermaid 다이어그램

mermaid로 펜스 코드 블록을 열고 순서도나 시퀀스 다이어그램을 일반 텍스트로 설명하세요. Markdown Peek이 라이트 모드나 다크 모드로 그려줍니다.

Markdown

```mermaid
flowchart LR
  A[Write] --> B[Preview]
  B --> C[Share]
```

결과

WritePreviewShare

Mac에서 Markdown을 아름답게 읽으세요

Markdown Peek은 어떤 .md 파일이든 깔끔한 GitHub 스타일로 렌더링하며, Finder의 Quick Look과 PDF 저장을 지원합니다. Mac App Store에서 무료입니다.

Mac App Store에서 Markdown Peek 다운로드
Mac App Store에서 Markdown Peek 다운로드