[클로드 시리즈_05] 마크다운부터 이해하기 — Claude Skill이 .md 파일로 작동하는 진짜 이유

강호종 AI 길라잡이 강사 | 2026.05.02

---

핵심 결론 먼저

마크다운(Markdown)은 AI와 소통하는 공용 언어입니다. Claude Skill의 핵심 파일이 SKILL.md인 이유, 정부가 회의록을 .md로 공개하는 이유, AI 도구들이 모두 마크다운을 채택한 이유—이 모든 것의 뿌리가 마크다운에 있습니다. Claude를 제대로 활용하려면 마크다운을 먼저 이해해야 합니다.

---

1. 마크다운이 뭔가요? — AI 공부를 하다 마주친 그 기호들

Claude나 ChatGPT를 쓰다 보면 이런 기호들이 답변에 등장합니다.

# 제목
## 소제목
**굵은 글씨**
- 목록 항목

처음엔 그냥 무시하게 됩니다. 그런데 이게 단순한 장식이 아닙니다. AI에게 질문하면 답변에 #, *, - 같은 기호들이 보이는데, 이것은 단순한 장식이 아니라 문서 구조를 표현하는 문법입니다. 마크다운은 복잡한 코딩 없이도 간단한 기호만으로 제목, 강조, 목록 등을 표현하는 방식이고, .md로 끝나는 파일은 바로 마크다운 형식의 문서입니다. 

마크다운은 2004년 존 그루버(John Gruber)와 에런 스워츠(Aaron Swartz)가 만든 경량 마크업 언어입니다. 제목에는 #, 굵은 글씨에는 **, 목록에는 -와 같은 간단하고 직관적인 기호를 사용해 일반 텍스트에 서식을 추가할 수 있으며, 이를 HTML, PDF, Word 문서 등 다양한 형식으로 변환할 수 있습니다. 

강의 현장에서 제가 자주 쓰는 비유가 있습니다. 마크다운은 **"AI가 읽을 수 있는 워드 문서"**라고 생각하면 됩니다. 워드는 사람이 보기 좋게 꾸며주지만 AI가 구조를 파악하기 어렵습니다. 마크다운은 사람이 읽기도 쉽고, AI도 구조를 즉시 이해합니다.

---

2. 마크다운 문법 — 10분이면 충분합니다

마크다운을 코딩이라고 오해하시는 분들이 많습니다. 그렇지 않습니다. 기호 몇 개면 끝납니다.

핵심 문법표

기호	결과	사용 예시
#	큰 제목(H1)	# 오늘의 보고서
##	중간 제목(H2)	## 1. 핵심 현황
**텍스트**	굵게	**핵심 결론 먼저**
- 항목	• 목록	- 담당자 : 김철수
1. 항목	번호 목록	1. 문제 2. 원인 3. 해결
> 인용	인용문	> 출처 : Anthropic 공식 문서
---	구분선	섹션 구분할 때 사용

이게 전부입니다. 이 7가지만 알면 Claude Skill 파일(SKILL.md)을 읽고 수정하는 데 전혀 문제가 없습니다.

Before / After — 마크다운 없을 때 vs 있을 때

Before (마크다운 없이 AI에게 지시)

보고서는 A4 2페이지 이내로 작성하고 결론을 먼저 쓰고 
숫자와 날짜를 꼭 넣고 과장 표현은 쓰지 마세요

After (마크다운 구조로 AI에게 지시)

## 보고서 작성 기준

**형식**
- 분량 : A4 2페이지 이내
- 구조 : 결론 → 배경 → 데이터 (역피라미드)

**필수 포함**
- 수치와 날짜 명시

**금지사항**
- 과장 표현 사용 금지

같은 내용인데 결과물이 완전히 달라집니다. 마크다운으로 구조화된 지시는 AI가 '위계'를 파악하고 우선순위를 잡기 때문입니다.

---

3. 마크다운이 AI 친화적인 진짜 이유

2026년 마크다운은 LLM 훈련 데이터, RAG(검색 증강 생성) 시스템, Notion과 Obsidian 같은 현대 지식 베이스의 표준 형식이 되었습니다. AI 생성 콘텐츠가 대중화됨에 따라, 마크다운은 더 이상 개발자만의 도구가 아닌 인간과 AI의 협업을 위한 보편적 언어가 되었습니다. 

왜 AI는 마크다운을 좋아할까요? 세 가지 이유입니다.

1. 구조가 보입니다 #은 가장 중요한 정보, ##은 그 다음, -는 세부 내용. AI가 문서의 위계를 즉시 파악합니다. 줄글로만 쓰인 텍스트는 AI가 어디가 중요한지 스스로 추론해야 합니다.

2. 잡음이 없습니다 워드나 한글 문서는 폰트 정보, 색상 코드, 여백 설정 등 AI가 처리할 필요 없는 정보가 가득합니다. 마크다운은 내용만 있습니다.

3. 어디서든 읽힙니다 GitHub, GitLab, Reddit, Stack Overflow, Discord, Slack, Notion, Obsidian, Joplin — 마크다운을 지원하는 플랫폼과 도구의 목록은 방대하며 계속 늘어나고 있습니다. 한 번 작성하면 어디서든 깔끔하게 표시됩니다. 

---

4. SKILL.md — 마크다운이 Claude Skill의 심장인 이유

이제 핵심입니다. Claude Skill의 파일 이름이 왜 SKILL.md일까요?

모든 Skill에는 두 부분이 있는 SKILL.md 파일이 필요합니다: Claude에게 Skill을 언제 사용할지 알려주는 YAML frontmatter(--- 마커 사이)와 Skill이 호출될 때 Claude가 따르는 지침이 있는 마크다운 콘텐츠입니다. 

실제 SKILL.md 구조를 보면 마크다운이 왜 필요한지 바로 이해됩니다.

markdown

---
name: blog-writer
description: SEO 블로그 글을 작성합니다. "블로그", "포스팅"이 포함되면 실행합니다.
---

## 역할
너는 SEO 전문 블로그 작가다.

## 작성 기준
- 제목 : 3초 안에 훅이 걸릴 것
- 구조 : 결론 먼저 (역피라미드)
- 분량 : 3000~4500자

## 금지사항
- 과장 표현 금지
- AI가 쓴 티가 나는 문장 금지

위에서 --- 사이가 YAML(설정 영역), 그 아래가 마크다운(지시 영역)입니다. Claude는 이 파일을 읽고 언제 이 스킬을 꺼낼지, 어떻게 행동할지를 동시에 파악합니다.

Claude Skills는 특정 작업 수행에 필요한 지침, 스크립트, 리소스를 하나의 폴더에 패키징한 '전문 지식 패키지'입니다. 마치 신규 입사자가 업무 매뉴얼을 습득한 후 독립적으로 업무를 수행하듯, Claude는 Skill의 지침을 내재화해 적절한 도구와 스크립트를 선택해 작업을 완수합니다. 

마크다운이 없으면 이 '업무 매뉴얼' 자체가 존재할 수 없습니다.

---

5. 정부도 마크다운을 도입했습니다 — 2026년 현실

정부 기관이 분과별 회의 및 토론 결과를 AI 친화적 텍스트 형식인 마크다운(.md)으로 작성하고 위원회 누리집에 공개하겠다는 발표는 수많은 개발자, PM, 기획자들에게 빠르게 공유되었습니다.

국가인공지능전략위원회의 이 움직임은 중요한 신호입니다. 공공문서의 AI 친화적 포맷 전환이 공식화되고 있다는 뜻입니다. 마크다운을 모르면 앞으로 AI 기반 행정·업무 시스템에서 뒤처질 수 있습니다.

다만 현실적인 주의도 필요합니다. 실무자의 시선에서 원본 데이터를 직접 확인해본 결과, AI가 문맥을 이해하는 데 필수적인 헤더 태그(#), 볼드체(**), 인용구(>) 등의 구조적 마크업은 전무했습니다. 형식만 .md로 바꾸고 내용은 여전히 줄글이면 아무 의미가 없습니다. 마크다운은 파일 확장자가 아니라 '생각의 구조화 방식'입니다. 

---

6. 실전 적용 — 지금 당장 마크다운으로 AI에게 지시하기

마크다운 에디터를 따로 설치할 필요도 없습니다. Claude 채팅창에 그냥 마크다운 기호를 쓰면 됩니다. 아래 3가지 상황별 예시를 바로 복사해서 써보세요.

상황 1. 보고서 초안 요청할 때

markdown

## 보고서 요청

**주제** : 2026년 상반기 AI 교육 성과 보고

**형식**
- A4 2페이지 이내
- 결론 → 수치 → 배경 순서

**포함 내용**
1. 교육 참여자 수 및 만족도
2. 전년 대비 변화
3. 다음 분기 계획

**톤** : 공식적, 과장 표현 금지

상황 2. 이메일 초안 요청할 때

markdown

## 이메일 작성 요청

**수신자** : 거래처 담당자 (처음 연락)
**목적** : 미팅 제안
**핵심 메시지** : AI 업무 효율화 솔루션 소개

**조건**
- 700자 이내
- 정중하되 딱딱하지 않은 톤
- 다음 주 화·수요일 미팅 가능 여부 확인

상황 3. SKILL.md 직접 만들 때

markdown

---
name: email-draft
description: 업무 이메일 초안을 작성합니다. "이메일", "메일 써줘"가 포함되면 실행합니다.
---

## 역할
B2B 영업 전문가로서 이메일을 작성한다.

## 기본 원칙
- 700자 이내
- 요청은 딱 1가지만
- 마무리에 다음 단계 명시

---

7. Q&A — 마크다운에 대해 가장 많이 묻는 질문 5가지

Q1. 마크다운을 배워야 Claude를 잘 쓸 수 있나요?

필수는 아니지만, 알면 Claude의 결과물 품질이 눈에 띄게 달라집니다. 특히 SKILL.md를 직접 수정하거나 복잡한 조건을 AI에게 전달할 때 마크다운 구조로 작성하면 오해 없이 전달됩니다. 기본 7개 문법만 익혀도 충분합니다.

Q2. 마크다운 파일(.md)은 어디서 열어보나요?

윈도우라면 메모장에서도 열립니다. 다만 기호가 그대로 보입니다. 렌더링된 상태(기호가 서식으로 변환된 상태)로 보려면 VS Code, Notion, Obsidian, 또는 온라인 마크다운 에디터(markdownlivepreview.com 등)를 사용하면 됩니다. Claude 채팅창 자체도 마크다운을 렌더링해줍니다.

Q3. SKILL.md에서 YAML과 마크다운은 어떻게 구분하나요?

---(하이픈 세 개) 사이가 YAML 영역(이름·설명 등 설정값), 그 아래가 마크다운 영역(실제 지시 내용)입니다. YAML은 Claude가 '언제 이 스킬을 꺼낼지'를 결정하는 데 쓰이고, 마크다운 본문은 '어떻게 행동할지'를 지시합니다.

Q4. Claude에게 마크다운 형식으로 답변하라고 요청할 수 있나요?

물론입니다. "마크다운 형식으로 답변해줘"라고 하면 됩니다. 반대로 "마크다운 기호 없이 줄글로 써줘"도 됩니다. Claude는 상황에 맞게 두 가지 모두 처리할 수 있습니다. 긴 보고서나 구조화된 정보는 마크다운으로, 짧은 대화나 이메일 본문은 줄글로 요청하는 게 실무에서 더 자연스럽습니다.

Q5. 마크다운이 AI에게 왜 '구조'를 전달하는 건가요?

마크다운 파서가 ## 장보기 목록을 만나면 ## 패턴을 인식하고 <h2>장보기 목록</h2>을 출력합니다. AI는 이 구조를 통해 "이 내용이 소제목 수준의 중요한 정보구나"를 파악합니다. 줄글에서는 이 위계가 보이지 않으니 AI가 스스로 중요도를 추론해야 하고, 그게 결과물의 품질 차이로 이어집니다. 

---

8. 오늘 당장 해볼 수 있는 3가지 액션

1. 지금 Claude 채팅창을 열고 마크다운 기호를 직접 써보세요. ##으로 소제목을 만들고, -로 목록을 만들어 보고서 초안을 요청해보세요. 평소와 결과물이 얼마나 다른지 바로 확인됩니다.
2. 기존에 자주 쓰던 프롬프트를 마크다운 구조로 재작성해보세요. 역할, 조건, 금지사항을 ##과 -로 나누어 정리하면 SKILL.md의 절반은 완성된 것입니다.
3. SKILL.md 파일을 메모장으로 열어보세요. claude.ai > 사용자 지정 > 스킬에서 다운로드한 SKILL.md를 메모장으로 열면 구조가 눈에 들어옵니다. 지시문을 직접 수정하고 업로드하면 나만의 맞춤 스킬이 됩니다.

---

마무리 — 마크다운은 AI와 소통하는 공용 언어

저는 강의에서 이렇게 말합니다.

"워드는 사람이 보기 좋은 문서, 마크다운은 사람과 AI가 함께 보기 좋은 문서입니다."

AI 시대의 문서 작성 표준이 마크다운으로 이동하고 있습니다. SKILL.md, CLAUDE.md, README.md—앞으로 여러분이 접하게 될 AI 관련 파일들은 대부분 .md 확장자입니다. 이 파일을 두려워하지 않고 읽고 수정할 수 있다면, AI 활용 수준이 한 단계 올라갑니다.

여러분은 마크다운 문법을 써보신 적 있으신가요? 처음 접하셨다면 오늘 배운 7가지 기호 중 어떤 것을 가장 먼저 써보고 싶으신지 댓글로 알려주세요! 다음 포스팅에서는 마크다운으로 나만의 SKILL.md를 직접 만드는 실전 가이드를 다뤄보겠습니다.

---

강호종 AI 길라잡이 강사
생성형 AI 활용 업무 효율화 전문강사 · 디지털융합교육원 지도강사  · 젠스파크 AI 전문강사 · (사)한국AINFT협회 이사
저서 : 『생성형 AI 활용 업무혁신』(2026) · 『이것이 GEO마케팅이다』(2026) 외
📞 010-9912-9934 · 📧 art386@naver.com · blog.naver.com/art386

---

#마크다운 #Markdown #마크다운이란 #SKILL.md #Claude스킬 #ClaudeSkill #클로드활용 #AI문서작성 #AI친화적문서 #생성형AI #강호종강사 #AI길라잡이 #직장인AI #프롬프트구조화 #AI업무효율화 #마크다운문법 #마크다운기초 #ClaudeCode #2026AI #AI공용언어