마크다운 완벽가이드 1편 - 기초#

요약#

이 글의 핵심 3가지

마크다운의 본질: 읽기 쉽고 쓰기 쉬운 평문 문서 작성 도구

범용성: Astro, GitHub, 옵시디언 등 어디서나 사용 가능

기본 문법: 제목, 강조, 목록, 링크, 이미지 등 11가지 필수 문법

읽는 시간: 15분 | 난이도: 초급

출처#

이 글은 다음 자료를 바탕으로 작성되었습니다.

Markdown Guide - Getting Started - 마크다운 소개와 배경
Markdown Guide - Basic Syntax - 기본 문법 완전 가이드

대상 독자: 마크다운 문법에 관심있는 입문자

마크다운이란?#

마크다운은 평문 문서에 서식 요소를 추가할 수 있는 가벼운 마크업 언어입니다.

1
# 제목입니다
2

3
**굵은 텍스트**입니다

이 텍스트는 나중에 HTML로 변환되어 웹에서 보여집니다.

마크다운의 역사#

2004년 John Gruber가 만들었습니다. 설계 철학은 단순했습니다.

문법이 읽기 쉽고 눈에 띄지 않아야 한다.

20년이 지난 지금, 마크다운은 세계에서 가장 인기 있는 마크업 언어 중 하나가 되었습니다.

왜 마크다운을 배워야 할까요?#

1. 어디서나 쓸 수 있습니다#

마크다운은 평문 텍스트라서 모든 운영체제, 모든 에디터에서 열 수 있습니다.

Mac TextEdit
Linux Vim
VS Code
옵시디언

어떤 도구를 쓰든 .md 파일 하나면 됩니다.

2. 플랫폼이 지원합니다#

GitHub, Reddit, Discord, Notion 등 주요 플랫폼이 마크다운을 지원합니다.

Astro 블로그는 포스트를 전부 마크다운으로 작성하며, 옵시디언 또한 마크다운 전용 노트 앱입니다.

3. 미래에도 쓸 수 있습니다#

마크다운은 순수 텍스트 파일입니다. 특정 프로그램이 사라져도 파일은 그대로 읽을 수 있습니다.

10년 전에 작성한 .md 파일을 지금 열어도 문제없습니다.

4. 배우기 쉽습니다#

HTML은 입문자가 보기에 몇 시간이 걸립니다. (저는 그랬습니다..)

마크다운은 30분이면 충분합니다.

기능	HTML	마크다운
제목	`<h1>제목</h1>`	`# 제목`
굵게	`<strong>텍스트</strong>`	`텍스트`
링크	`<a href="URL">텍스트</a>`	`[텍스트](URL)`

어느 쪽이 간단한가요?

마크다운 작동 방식#

마크다운 프로세스는 4단계입니다.

.md 파일 생성 (텍스트 에디터)
마크다운 애플리케이션에서 열기
HTML로 변환 (마크다운 파서가 처리)
웹 브라우저에서 보거나 PDF로 내보내기

Astro 예시:

1
# 안녕하세요
2

3
이것은 마크다운입니다.

↓ 빌드 후

1
<h1>안녕하세요</h1>
2
<p>이것은 마크다운입니다.</p>

기본 문법#

1. Headings (제목)#

# 기호로 제목을 만듭니다. # 개수가 제목 레벨입니다.

1
# 제목 1
2

3
## 제목 2
4

5
### 제목 3
6

7
#### 제목 4
8

9
##### 제목 5
10

11
###### 제목 6

결과:

제목 1#

제목 2#

제목 3#

제목 4#

제목 5#

제목 6#

모범 사례:

✅ 올바른 방법

1
# 제목 (공백 포함)

❌ 피해야 할 방법

1
#제목 (공백 없음)

팁: 제목 앞뒤로 빈 줄을 추가하면 호환성이 높아집니다.

2. Paragraphs (단락)#

빈 줄로 단락을 구분합니다.

1
첫 번째 단락입니다.
2

3
두 번째 단락입니다.

모범 사례:

✅ 올바른 방법

1
단락 1
2

3
단락 2

❌ 피해야 할 방법

1
    들여쓰기한 단락 (목록 제외)

3. Line Breaks (줄바꿈)#

줄바꿈은 공백 2개 + Enter 또는 <br> 태그를 씁니다.

1
첫 번째 줄. (안보이겠지만 공백 2개가 들어가있음)
2
두 번째 줄.

또는

1
첫 번째 줄.<br>
2
두 번째 줄.

모범 사례:

✅ 올바른 방법

1
줄 1.
2
줄 2.

❌ 피해야 할 방법

1
줄 1.\
2
줄 2. (백슬래시는 호환성 문제 있음)

4. Emphasis (강조)#

Bold (굵게)#

별표 2개(**) 또는 언더스코어 2개(__)로 감쌉니다.

1
**굵은 텍스트**
2
**굵은 텍스트**

결과: 굵은 텍스트

단어 중간 강조:

1
Love**is**bold

결과: Loveisbold

모범 사례:

✅ 올바른 방법

1
Love**is**bold (별표 사용)

❌ 피해야 할 방법

1
Love**is**bold (언더스코어는 작동 안 함)

Italic (기울임)#

별표 1개(*) 또는 언더스코어 1개(_)로 감쌉니다.

1
_기울인 텍스트_
2
_기울인 텍스트_

결과: 기울인 텍스트

단어 중간 기울임:

1
A*cat*meow

결과: Acatmeow

Bold and Italic (굵고 기울임)#

별표 3개(***) 또는 조합(**_텍스트_**)을 씁니다.

1
**_정말 중요_**
2
**_정말 중요_**

결과: 정말 중요

5. Blockquotes (인용구)#

> 기호로 인용구를 만듭니다.

1
> 이것은 인용구입니다.

결과:

이것은 인용구입니다.

여러 단락 인용#

1
> 첫 번째 단락
2
>
3
> 두 번째 단락

결과:

첫 번째 단락

두 번째 단락

중첩 인용구#

1
> 외부 인용
2
>
3
> > 내부 인용

결과:

외부 인용

내부 인용

다른 요소 포함#

1
> #### 제목
2
>
3
> - 항목 1
4
> - 항목 2
5
>
6
> *강조*와 **굵게**

결과:

제목#

항목 1

항목 2

강조와 굵게

6. Lists (목록)#

Ordered Lists (순서 있는 목록)#

숫자 + 점(.)을 씁니다.

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

결과:

첫 번째
두 번째
세 번째

팁: 숫자는 전부 1.로 써도 됩니다.

1
1. 항목
2
1. 항목
3
1. 항목

자동으로 1, 2, 3으로 바뀝니다. 항목 순서를 바꿀 때 편합니다.

중첩 목록:

1
1. 첫 번째
2
2. 두 번째
3
   1. 중첩 항목 (4칸 들여쓰기)
4
   2. 중첩 항목
5
3. 세 번째

Unordered Lists (순서 없는 목록)#

-, *, + 중 하나를 씁니다.

1
- 항목 1
2
- 항목 2
3
- 항목 3

결과:

항목 1
항목 2
항목 3

중첩 목록:

1
- 항목 1
2
  - 중첩 항목 (2칸 들여쓰기)
3
  - 중첩 항목
4
- 항목 2

결과:

항목 1
- 중첩 항목
- 중첩 항목
항목 2

모범 사례:

✅ 올바른 방법

1
- 항목 1
2
- 항목 2

❌ 피해야 할 방법

1
- 항목 1
2

3
* 항목 2 (기호 혼합 금지)

목록에 다른 요소 추가#

단락 추가:

1
- 첫 번째 항목
2
- 두 번째 항목
3

4
  추가 단락 (4칸 들여쓰기)
5

6
- 세 번째 항목

코드 블록 추가:

1
1.  파일 열기
2
2.  코드 찾기:
3

4
        <html>
5
          <title>Test</title>
6
        </html>
7

8
3.  제목 업데이트

목록에서 코드 블록은 8칸 들여쓰기입니다.

7. Code (코드)#

Inline Code (인라인 코드)#

백틱(`)으로 감쌉니다.

1
`console.log('Hello')`는 자바스크립트 코드입니다.

결과: console.log('Hello')는 자바스크립트 코드입니다.

백틱 이스케이프:

코드 안에 백틱을 쓰려면 백틱 2개로 감쌉니다.

1
``코드에서 `backtick` 사용하기``

결과: 코드에서 `backtick` 사용하기

Code Blocks (코드 블록)#

4칸 들여쓰기 또는 1탭을 씁니다.

1
    <html>
2
      <head></head>
3
    </html>

결과:

1
<html>
2
  <head></head>
3
</html>

참고: 펜스 코드 블록(```)은 확장 문법입니다. 2편에서 다룹니다.

8. Horizontal Rules (수평선)#

***, ---, ___ 중 하나를 씁니다.

1
---

결과:

모범 사례:

✅ 올바른 방법

1
단락
2

3
---
4

5
다음 단락 (앞뒤로 빈 줄)

❌ 피해야 할 방법

1
## 단락
2

3
다음 단락 (제목처럼 보임)

9. Links (링크)#

[텍스트](URL) 형식입니다.

1
[Markdown Guide](https://www.markdownguide.org)

결과: Markdown Guide

제목 추가#

1
[Markdown Guide](https://www.markdownguide.org "최고의 마크다운 가이드")

마우스를 올리면 “최고의 마크다운 가이드”가 보입니다.

URL과 이메일 빠른 변환#

<URL> 형식으로 쓰면 자동으로 링크가 됩니다.

1
<https://www.markdownguide.org>
2
<[email protected]>

결과:

https://www.markdownguide.org [email protected]

링크 강조#

1
**[굵은 링크](https://example.com)**
2
_[기울인 링크](https://example.com)_
3
[`code` 링크](#code)

결과:

굵은 링크 기울인 링크 code 링크

모범 사례:

✅ 올바른 방법

1
[링크](https://example.com/my%20page)

❌ 피해야 할 방법

1
[링크](https://example.com/my page) (공백 인코딩 필요)

10. Images (이미지)#

링크 앞에 !를 붙입니다.

1
![대체 텍스트](/경로/이미지.jpg)

제목 추가:

1
![산 사진](/images/산.jpg "산 풍경")

링크가 있는 이미지:

1
[![이미지 설명](/경로/이미지.jpg)](https://example.com)

이미지를 클릭하면 링크로 이동합니다.

11. Escaping Characters (특수문자 이스케이프)#

백슬래시(\)로 마크다운 기호를 그대로 표시합니다.

1
\* 백슬래시가 없으면 목록이 됩니다.

결과: * 백슬래시가 없으면 목록이 됩니다.

이스케이프 가능한 문자:

문자	이름
`\\`	백슬래시
\`	백틱
`\*`	별표
`\_`	언더스코어
`\#`	해시
`\-`	하이픈
`\.`	점
`\!`	느낌표

실전 예제#

Astro 블로그 포스트 구조#

1
---
2
title: "마크다운으로 시작하는 블로그"
3
published: 2025-12-31
4
description: "마크다운 기본 문법 총정리"
5
category: "튜토리얼"
6
tags: ["마크다운", "블로그"]
7
---
8

9
# 마크다운으로 시작하는 블로그
10

11
## 기본 문법 요약
12

13
마크다운은 **읽기 쉽고** _쓰기 쉬운_ 문법입니다.
14

15
### 주요 기능
16

17
1. 제목
18
2. 강조
19
3. 목록
20

21
자세한 내용은 [공식 가이드](https://www.markdownguide.org)를 참고하세요.
22

23
---
24

25
## 참고 자료
26

27
- [Markdown Guide](https://www.markdownguide.org)

옵시디언 노트 예시#

1
# 마크다운 학습 노트
2

3
## 오늘 배운 것
4

5
- **제목**: `#` 기호 사용
6
- **강조**: `**굵게**`, `*기울임*`
7
- **목록**: `-` 또는 `1.`
8

9
## 다음 단계
10

11
> 확장 문법(Extended Syntax) 배우기
12

13
### 관련 노트
14

15
- [[Astro 블로그 설정]]
16
- [[옵시디언 플러그인]]
17

18
#마크다운 #학습

참고 자료#

공식 문서#

Markdown Guide - 마크다운 공식 가이드
John Gruber’s Markdown - 마크다운 창시자의 원본 문서
CommonMark - 마크다운 표준 스펙

학습 자료#

Markdown Tutorial - 인터랙티브 튜토리얼
Awesome Markdown - 마크다운 리소스 모음

다음 편 예고#

마크다운 완벽가이드 2편 - 확장 문법에서는 다음 내용을 다룹니다:

테이블 (Tables)
펜스 코드 블록 (Fenced Code Blocks)
체크리스트 (Task Lists)
각주 (Footnotes)
취소선 (Strikethrough)
Emoji
그 외 고급 기능

기본 문법을 익혔다면, 2편에서 더 강력한 기능을 배워보세요!

마크다운 완벽가이드 1편 - 기초

마크다운 완벽가이드 1편 - 기초#

요약#

출처#

마크다운이란?#

마크다운의 역사#

왜 마크다운을 배워야 할까요?#

1. 어디서나 쓸 수 있습니다#

2. 플랫폼이 지원합니다#

3. 미래에도 쓸 수 있습니다#

4. 배우기 쉽습니다#

마크다운 작동 방식#

기본 문법#

1. Headings (제목)#

제목 1#

제목 2#

제목 3#

제목 4#

제목 5#

제목 6#

2. Paragraphs (단락)#

3. Line Breaks (줄바꿈)#

4. Emphasis (강조)#

Bold (굵게)#

Italic (기울임)#

Bold and Italic (굵고 기울임)#

5. Blockquotes (인용구)#

여러 단락 인용#

중첩 인용구#

다른 요소 포함#

제목#

6. Lists (목록)#

Ordered Lists (순서 있는 목록)#

Unordered Lists (순서 없는 목록)#

목록에 다른 요소 추가#

7. Code (코드)#

Inline Code (인라인 코드)#

Code Blocks (코드 블록)#

8. Horizontal Rules (수평선)#

9. Links (링크)#

제목 추가#

URL과 이메일 빠른 변환#

링크 강조#

10. Images (이미지)#

11. Escaping Characters (특수문자 이스케이프)#

실전 예제#

Astro 블로그 포스트 구조#

옵시디언 노트 예시#

참고 자료#

공식 문서#

학습 자료#

추천 에디터#

다음 편 예고#

공유

목차