Markdown: AI와 대화하는 보편적인 언어

이 장에서는 좀 더 가벼운 주제로 넘어가겠습니다. 여러분이 매일 사용하지만 이름은 모를 수도 있는 것, 바로 Markdown입니다.

먼저 대담한 주장 하나를 해보겠습니다.

Markdown은 AI 시대에 배워야 할 가장 중요한 형식입니다.

왜일까요? 계속 읽어보세요.

Markdown이란?

한 문장으로: Markdown은 기호를 사용해 서식을 제어하는 일반 텍스트 작성 방식입니다.

일반 텍스트에는 서식이 없습니다. 제목, 굵게, 목록 같은 것이 없죠. 반면 Word 같은 리치 텍스트 형식은 너무 무겁습니다. 전용 소프트웨어가 필요하고 파일 크기도 큽니다.

Markdown은 “딱 적당한” 중간 지점입니다. 몇 가지 간단한 기호만으로 일반 텍스트에 서식을 추가할 수 있습니다.

예를 들어 다음과 같이 작성하면:

# This is a heading
**This is bold**
- This is a list

서식이 적용된 제목, 굵은 텍스트, 목록으로 표시됩니다. 아주 간단하죠.

AI 시대에 Markdown을 꼭 배워야 하는 이유

이유 1: AI는 Markdown을 사용합니다

ChatGPT, Claude, Gemini 등 AI가 답변할 때 자동으로 굵은 텍스트, 제목, 목록, 코드 블록을 포함한다는 사실을 눈치채셨나요?

그게 바로 Markdown입니다.

AI는 Word 문서나 PDF를 출력하지 않습니다. AI의 기본 출력 형식은 Markdown입니다. 이 튜토리얼에서 보이는 모든 표, 굵은 텍스트, 코드 블록은 모두 Markdown입니다.

Markdown을 배우지 않는 것은 누군가와 대화하면서 그 사람이 쓰는 단어를 이해하지 못하는 것과 같습니다. 그래도 의사소통은 가능합니다. 하지만 훨씬 비효율적이죠.

이유 2: 어디에나 있습니다

Markdown은 특정 소프트웨어의 독점 형식이 아니라 보편적인 표준입니다. Markdown을 지원하는 도구는 셀 수 없이 많습니다.

카테고리	소프트웨어/플랫폼
노트 작성	Obsidian, Notion, Typora, Bear
코드 플랫폼	GitHub, GitLab, Bitbucket
블로그 시스템	Hugo, Jekyll, Hexo
문서 도구	Confluence, Feishu Docs, Yuque
AI 도구	ChatGPT, Claude, Gemini, Claude Code, Codex

하나의 형식을 배우면 어디서든 사용할 수 있습니다. Obsidian에서 작성한 노트를 GitHub에 복사해도 서식이 유지됩니다. AI에 던져도 완벽하게 이해합니다. Word로 그렇게 해보세요?

이유 3: 파일 크기가 놀라울 정도로 작습니다

놀라실 수도 있습니다. 같은 내용일 때 Markdown 파일은 Word 파일보다 20배 이상 작습니다.

왜일까요? Word .docx 파일은 본질적으로 XML 파일을 압축한 아카이브로, 스타일 정의, 글꼴 정보, 문서 속성이 가득합니다. 한 줄만 써도 파일 크기는 수십 KB입니다.

Markdown은 일반 텍스트입니다. 파일 크기는 작성한 텍스트 양과 같습니다. 불필요한 것이 전혀 없습니다.

이 점은 AI 시나리오에서 특히 중요합니다. AI에 문서를 보내 분석할 때 Markdown은 더 적은 토큰을 소비하고, 처리 속도가 빠르며, 비용이 적게 듭니다. Word 파일의 XML 태그와 스타일 정의는 모두 토큰으로 계산되어 낭비됩니다.

이유 4: AI가 Markdown을 더 잘 이해합니다

많은 사람들이 이 사실을 모릅니다.

AI에 Word 문서를 주면 먼저 텍스트로 변환해야 합니다. 변환 과정에서 서식이 손실되고, 표가 어긋나며, 이미지가 사라질 수 있습니다.

AI에 Markdown 파일을 주면 직접 읽습니다. Markdown은 그 자체로 일반 텍스트이므로 변환이 필요 없고 손실이 전혀 없습니다.

더 중요한 점은, Markdown 기호(제목의 #, 목록의 -, 코드의 `)가 AI에게 명확한 의미를 전달한다는 것입니다. AI는 #을 보면 “이것은 제목이다"라고 이해하고, `을 보면 “이것은 코드다"라고 이해합니다. 이러한 구조적 정보는 AI가 문서의 논리적 구조를 더 정확하게 파악하는 데 도움이 됩니다.

10분 만에 Markdown 마스터하기

Markdown을 배우는 것은 생각보다 훨씬 쉽습니다. 대부분의 사람들은 10분 안에 기본을 익히고, 나머지는 필요할 때 찾아보면 됩니다.

핵심 문법 (5분 학습)

제목(6단계): # 기호를 사용합니다. #이 많을수록 더 작은 제목입니다.

``` ``) inherently tell the AI, “this is a heading, this is a list, this is code.” The AI can understand your content structure more accurately.

Learn Markdown in 10 Minutes

There are only about a dozen Markdown syntax elements, and even fewer are needed for daily use. Below, they are ordered by frequency of use, starting with the most common.

1. Headings

Use # followed by a space. The number of # symbols indicates the heading level:

# 제목 1 (가장 큼)
## 제목 2
### 제목 3
#### 제목 4

For daily use, up to level 3 is enough.

2. Bold and Italic

**굵은 텍스트**
*기울임 텍스트*
***굵게 + 기울임 텍스트***

Bold is used most often, italic occasionally.

3. Lists

Unordered lists use - or *:

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

Ordered lists use numbers followed by a period:

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

Lists can be nested by adding two spaces before the sub-item:

- 주요 항목
  - 하위 항목
  - 하위 항목

4. Code

Inline code uses single backticks:

도움말을 보려면 `claude --help`를 입력하세요

Result: Type claude --help to see help

Code blocks are wrapped with three backticks, and you can specify the language:

```python
print("Hello World")
```

This is especially useful when communicating with AI. When sending code to an AI, wrap it in a code block so the AI can more accurately identify the code boundaries.

5. Links and Images

[링크 텍스트](https://example.com)
![](https://example.com/image.png)

Images are just links with a ! in front.

6. Blockquotes

Start with >:

> 이것은 인용문입니다.
> 여러 줄에 걸칠 수 있습니다.

Result:

This is a blockquote. It can span multiple lines.

7. Tables

| 열 1 | 열 2 | 열 3 |
|----------|----------|----------|
| 내용 | 내용 | 내용 |
| 내용 | 내용 | 내용 |

Table syntax looks complex, but you don’t need to write it by hand. Just ask the AI to generate it for you. Say “organize this data into a table,” and the AI will output a Markdown table.

8. Horizontal Rules

Three or more - on a single line:

---

Used to separate different sections of an article.

9. Strikethrough

~~삭제된 텍스트~~

Result: ~~Deleted text~~

That’s Enough, Really

The 9 syntax elements above cover 99% of daily use cases.

You don’t need to master Markdown. Headings, bold, lists, and code blocks—master these four and you can handle most situations. Look up the rest when needed.

And Markdown has one advantage: It’s okay if you can’t remember it all now; you’ll learn it by using it. AI outputs Markdown, so as you read AI responses every day, you’ll naturally become familiar with these symbols.

How to Use Markdown to Improve Communication with AI

After learning Markdown, here are a few tips to make your conversations with AI more effective:

Tip 1: Use headings to structure your input

# 배경
블로그 프로젝트를 진행 중입니다...

# 요구사항
다음 기능을 구현하는 데 도움을 주세요:
1. 글 목록 페이지
2. 글 상세 페이지

# 제약사항
- Hugo 프레임워크 사용
- 데이터베이스 불필요

Much better than a big block of text. With headings, the AI can more accurately understand the structure of your request.

Tip 2: Wrap code in code blocks

Don’t just paste code directly; wrap it in a code block:

이 코드에 무엇이 문제인지 확인해 주세요:

```python
def hello()
    print("hello")
```

The AI can precisely distinguish between your words and the code.

Tip 3: Use lists to enumerate requirements

다음 요구사항에 맞게 글을 작성해 주세요:
- 약 1000단어
- 대화체 스타일
- 세 개의 섹션으로 나누기
- 각 섹션에 소제목 포함

Much clearer than “Write me an article around 1000 words conversational style divided into three sections each with a subheading.”

Where to Practice?

You don’t need to find a specific place to practice. If you’re using Claude Code or Codex as you follow this tutorial, you’re using Markdown every day—you just didn’t know its name.

If you want a dedicated place to write Markdown, here are a few recommendations:

Tool	Features
Obsidian	Free, local storage; the author’s other book “Obsidian Handbook” covers it in detail
Typora	WYSIWYG, best Markdown writing experience, paid
VS Code	Free, install a preview extension and you’re good to go
Online Editors	Search for “Markdown online editor” and start using immediately

Beginners are recommended to use Obsidian. It’s free, easy to use, and works well with AI. If you want to dive deeper, check out the author’s other book, “Obsidian Handbook.”

Summary

What you learned today:

What Markdown is: A way to write plain text with formatting controlled by symbols, over 20 times lighter than Word
Why learn it in the AI era: AI outputs Markdown, it’s everywhere, files are small, AI understands it better
Core syntax (4 are enough): Headings #, bold **, lists -, code blocks ```
완전한 문법 (99% 커버): 링크, 이미지, 인용문, 표, 수평선 추가
AI와 소통하는 팁: 제목으로 구조화, 코드는 코드 블록에, 요구사항은 목록으로

핵심 요약:

Markdown은 AI의 “모국어"입니다. 배우는 것은 AI와 효율적으로 소통하는 법을 배우는 것입니다.
기본은 10분 안에 배우고, 나머지는 필요할 때 찾아보세요.
일부러 연습할 필요 없습니다. AI를 사용하면서 자연스럽게 익힐 수 있습니다.