마크다운(Markdown)이란? 제목·목록·링크부터 README 작성법까지
AI에게 웹사이트를 만들어 달라고 했더니 README.md와 CLAUDE.md라는 파일이 생겼습니다.
파일을 열어 보니 다음처럼 평범한 문장 앞에 #이나 -가 붙어 있었습니다.
# 나의 첫 웹사이트
## 설치 방법
- HTML 파일 열기
- 필요한 도구 확인
처음에는 “이상한 기호가 왜 이렇게 많지?”라고 생각할 수 있습니다. 사실 이 기호는 컴퓨터에게 이 부분은 제목, 이 부분은 목록이라고 알려 주는 간단한 약속입니다. 이 약속을 사용하는 글쓰기 방식을 마크다운(Markdown)이라고 부릅니다. 마크다운은 일반 텍스트에 몇 가지 기호를 붙여 제목·목록·링크·코드 등을 표현하는 가벼운 문서 작성 문법입니다. 복잡한 디자인 프로그램을 열지 않아도 메모장 같은 텍스트 편집기로 작성할 수 있고, GitHub 등 마크다운을 지원하는 화면에서는 읽기 쉬운 문서로 표시됩니다. 이번 글에서는 뜻부터 기본 문법, 간단한 실습, GitHub에서 보는 방법, AI에게 요청할 때의 주의사항까지 순서대로 설명합니다. 2026년 10월 16일 CommonMark와 GitHub 공식 문서를 기준으로 정리했습니다. 화면 표시 방식은 앱·사이트에 따라 달라질 수 있으며 아래 예제는 교육용입니다.
1. 마크다운은 프로그래밍 언어인가요?
아닙니다. 마크다운은 일반적으로 문서를 꾸미고 구조화하는 표기법이지, 명령을 계산하거나 컴퓨터에 파일을 삭제시키는 프로그래밍 언어가 아닙니다. 쉽게 비유하면 다음과 같습니다. 일반 텍스트: 공책에 문장만 연속으로 적기 마크다운: 중요한 줄에는 ‘제목’, 설명에는 ‘목록’, 참고 자료에는 ‘링크’ 표시를 붙여 정리하기 HTML: 웹페이지의 구조를 태그로 표현하는 방식 예를 들어 같은 제목을 마크다운과 HTML로 쓰면 다음처럼 달라집니다. 마크다운 입력:
# 오늘 배울 AI 용어
HTML 입력:
<h1>오늘 배울 AI 용어</h1>
둘 다 제목을 표현할 수 있지만 작성 방식이 다릅니다. 마크다운은 기호가 간단해 사람이 원본 텍스트를 직접 읽기도 쉽다는 것이 장점입니다. 주의: 모든 마크다운 문법이 그대로 HTML로 변하는 과정은 앱마다 다릅니다. 코드·HTML 삽입 처리와 보안 정책도 렌더러에 따라 다릅니다.
2. .md 파일이란 무엇인가요?
마크다운 문서는 보통 .md라는 확장자를 사용합니다.
예를 들어 다음 파일 이름을 볼 수 있습니다.
README.md: 프로젝트 소개·설치 방법을 적는 문서CLAUDE.md: Claude Code에서 프로젝트 지침을 작성할 때 사용할 수 있는 문서notes.md: 사용자가 개인 메모를 저장한 문서 파일 이름에서.md는 마크다운 형식의 텍스트가 들어 있을 가능성이 높다는 표시입니다. 그러나.md로 저장한다고 해서 AI가 자동으로 읽거나, 인터넷에 자동 공개되거나, 해당 파일의 모든 내용을 강제 규칙으로 따르는 것은 아닙니다. 파일을 어떤 프로그램이 열고, 읽고, 어떻게 해석하는지가 별개의 문제입니다. 예를 들어 GitHub는README.md를 프로젝트 소개문처럼 표시할 수 있고, Claude Code의CLAUDE.md는 프로젝트 지침을 전달하는 용도로 쓰일 수 있습니다.
3. 제목은 # 기호로 구분하기
가장 먼저 익힐 문법은 제목(Heading)입니다.
문장 맨 앞에 # 기호를 적고 한 칸 띄운 뒤 제목을 씁니다.
# 큰 제목
## 중간 제목
### 작은 제목
일반적으로 #부터 ######까지 여섯 단계의 제목을 표현할 수 있습니다.
이것은 글자의 크기만 달라지는 장식이 아니라 문서의 구조를 나타내는 표시입니다.
예를 들어 큰 주제가 “여행 계획”이라면 다음처럼 정리하는 것이 자연스럽습니다.
# 서울 여행 계획
## 1일 차
### 오전에 방문할 장소
### 오후에 방문할 장소
## 2일 차
좋은 습관: 가장 큰 제목 아래 관련 내용별로 중간 제목을 배치하고, 제목 단계를 불필요하게 건너뛰지 않는 편이 읽기 좋습니다.
자주 하는 실수: #제목처럼 기호 뒤에 공백이 없으면 CommonMark에서는 일반적인 ATX 제목으로 인식되지 않을 수 있습니다.
4. 별표 ** 기호로 문장을 강조하기
글에서 중요한 문장만 눈에 띄게 표시하고 싶다면 굵게(Bold)를 사용합니다.
**이 문장은 중요합니다.**
기본적인 기울임꼴(Italic)은 다음처럼 적습니다.
*이 부분은 기울임꼴입니다.*
두 기호를 함께 쓰는 방법도 있습니다.
***강하게 강조합니다.***
마크다운 문법은 시각적으로 예뻐 보이게 만드는 것뿐 아니라 문장의 의미를 구분하는 것에도 도움이 됩니다. 그러나 문장 전체를 매번 굵게 표시하면 무엇이 중요한지 오히려 구분하기 어려워집니다. 초보자가 블로그 원고나 AI 지침을 작성한다면 핵심 문장 한두 개를 골라 강조하는 편이 읽기 쉽습니다.
5. 목록은 하이픈과 번호로 정리하기
마크다운에서 자주 쓰는 기능은 목록(List)입니다.
먼저 순서가 중요하지 않은 항목은 -와 공백을 이용할 수 있습니다.
- 아침 운동
- 책 읽기
- 오늘 할 일 정리
하나씩 따라 해야 하는 절차는 번호를 붙이면 됩니다.
1. 파일을 엽니다.
2. 내용을 확인합니다.
3. 수정한 뒤 저장합니다.
목록 앞 기호 뒤에 공백을 넣는 것을 기억하세요. 목록 안에 또 다른 목록을 만들 수도 있습니다.
- 웹사이트 준비
- 제목 정하기
- 이미지 확인
- 발행 전 검사
- 모바일 화면 확인
- 링크 정상 작동 확인
다만 목록을 들여쓰기하는 정확한 양은 부모 목록의 기호와 콘텐츠 위치에 따라 달라질 수 있습니다. 단순히 탭을 아무렇게나 여러 번 넣으면 원하지 않는 코드 블록이나 깨진 목록처럼 표시될 수 있습니다. GitHub의 미리보기 화면에서 계층이 정확한지 직접 확인하는 습관이 좋습니다.
6. 링크는 대괄호와 괄호를 사용합니다
참고 자료로 이동하는 링크를 만들고 싶다면 다음 문법을 사용합니다.
[보이는 글자](https://example.com)
앞의 [ ] 안에는 화면에 나타날 이름을, 뒤의 ( ) 안에는 이동할 주소를 적습니다.
예를 들어 공식 GitHub 문서를 연결할 때는 다음과 같이 작성할 수 있습니다.
[GitHub 공식 문서](https://docs.github.com/)
이 문법으로 만들어진 링크는 독자에게 목적지를 분명히 설명하는 문구로 표시할 수 있습니다.
주의: 링크 문법을 정확하게 썼어도 실제 URL이 존재하지 않으면 링크는 깨질 수 있습니다.
또 다른 사람이 보내 준 마크다운 원고에는 보이는 글자와 실제 연결 주소가 다를 수 있으므로 링크를 눌러 파일이나 로그인 화면으로 이동하기 전 목적지를 확인하세요.
블로그 편집 팁: 마크다운 링크를 Blogger에 게시할 때는 플랫폼이 마크다운을 지원하는지 먼저 확인해야 합니다. 단순히 마크다운 문자열을 붙여 넣으면 [제목](URL) 자체가 문자로 보일 수도 있습니다.
7. 이미지는 ![ ]로 설명과 주소를 적습니다
링크 앞에 느낌표 !를 붙이면 이미지 문법이 됩니다.
![검은 고양이가 창가에 앉아 있는 사진]()
여기서 대괄호 안의 문장은 대체 텍스트(alt text)입니다.
이미지를 불러올 수 없거나 보조 기술을 통해 내용을 이해해야 하는 사람에게 이미지가 무엇을 뜻하는지 설명할 수 있습니다.
images/cat.jpg는 실제 이미지 파일의 위치를 가리킵니다.
중요: 문법을 적는다고 실제 이미지 파일이 자동 생성되지는 않습니다. 경로의 파일이 존재해야 하고, 사이트에서 접근 가능해야 합니다.
또 이미지를 예쁘게 보이도록 하는 일과 사용 권한을 확인하는 일은 별개입니다. 이미지 저작권·라이선스와 출처를 확인한 뒤 사용하세요.
8. 코드에 쓰는 기호는 백틱입니다
AI가 만들어 준 명령어를 글 안에서 구별해 보여 주려면 인라인 코드(Inline code)를 이용할 수 있습니다.
파일 이름은 `README.md`입니다.
기호는 일반적인 작은따옴표가 아니라 백틱(backtick)입니다. 코드나 명령이 여러 줄이면 펜스로 감싼 코드 블록(fenced code block)을 사용할 수 있습니다. 아래 상자 안의 표기 자체가 예시입니다.
```javascript
console.log("안녕하세요");
```
코드 블록 첫 줄의 javascript는 일부 마크다운 렌더러에서 구문 강조 색상을 적용할 때 참고하는 언어 표시입니다.
하지만 언어 이름을 적는다고 코드가 실행되는 것은 아닙니다.
아주 중요한 구분: GitHub README에서 명령을 코드 블록으로 보여 준다고 해서 설치·삭제 명령이 자동 실행되는 것이 아닙니다. 실행하려면 별도 환경과 사용자의 행동이 필요합니다.
초보자에게 명령어를 제공할 때는 무엇이 코드 예시이고 무엇을 실제로 실행해야 하는지 구별해 주는 것이 좋습니다.
9. 인용문은 > 기호로 표현하기
다른 문장의 일부를 인용하거나 참고 사항을 구분하려면 > 기호를 활용할 수 있습니다.
> 이 부분은 참고 내용입니다.
인용문 안에 여러 문단을 넣으려면 줄별 구성을 주의해야 합니다.
주의: 인용문 표시가 있다고 출처 표시가 자동으로 생기는 것은 아닙니다. 실제 다른 사람의 문장을 인용했다면 출처·저작권·인용 분량을 따로 확인해야 합니다.
또 GitHub에서 사용할 수 있는 특수 알림 상자 형태인 [!NOTE] 등은 GitHub의 확장 동작에 해당할 수 있습니다.
따라서 모든 마크다운 편집기에서 같은 모양으로 나올 것이라고 가정하지 마세요.
10. 체크박스와 표도 마크다운인가요?
GitHub에서 README 파일을 보다 보면 아래처럼 체크박스가 보일 수 있습니다.
- [ ] 아직 끝내지 못한 작업
- [x] 완료한 작업
GitHub에서 지원하는 표 확장 문법은 다음처럼 파이프 기호로 쓸 수 있습니다.
| 항목 | 상태 |
| --- | --- |
| 글 작성 | 완료 |
| 이미지 검수 | 대기 |
다만 꼭 알아둘 사실이 있습니다.
체크박스와 파이프(|) 기반 표 문법은 모든 마크다운 환경에서 똑같이 지원하는 표준 기본 기능이 아닙니다.
GitHub는 CommonMark를 바탕으로 표·작업 목록·취소선 등을 추가한 GitHub Flavored Markdown(GFM)을 지원합니다.
CommonMark 자체만 지원하는 환경에서는 위의 표·체크박스가 기대했던 HTML 구조로 변환되지 않을 수 있습니다.
해결 방법: 글을 붙여 넣을 곳이 GitHub인지, 특정 메모 앱인지, Blogger인지 확인하고 해당 편집기의 미리보기에서 실제 표시를 확인하세요.
11. 줄을 바꾸고 싶은데 글이 붙어 보일 수 있나요?
가능합니다. 일반 문서 편집기에서는 엔터 키를 누르면 줄이 바뀐 것처럼 보일 수 있지만, 마크다운에서는 일반 줄바꿈과 새 문단을 다르게 처리할 수 있습니다. 초보자에게 가장 단순한 방법은 문단 사이에 빈 줄을 하나 넣는 것입니다.
첫 번째 문단입니다.
두 번째 문단입니다.
이 방식은 CommonMark에서 분명한 문단 구분을 표현합니다. 반면 한 문단 안에서 줄만 바꾼 경우 실제 표시 결과는 마크다운 렌더러의 설정에 따라 달라질 수 있습니다. 마크다운을 다른 플랫폼으로 옮겼을 때 줄바꿈이 이상해 보이면 기호를 더 많이 넣기 전에 문단 구분과 미리보기부터 확인하세요.
12. *와 # 기호를 글자 그대로 보여 주기
마크다운에서 *나 #는 특별한 의미를 가질 수 있습니다.
그러나 “마크다운 기호 자체”를 설명하고 싶다면 그대로 표시되어야 합니다.
한 가지 방법은 백슬래시(\)로 특수문자의 기능을 이스케이프하는 것입니다.
예를 들어 다음은 * 문자를 기울임꼴로 바꾸지 않고 보여 주려는 문장입니다.
\*는 목록이나 강조에 사용할 수 있는 기호입니다.
또 짧은 마크다운 문법을 설명할 때는 인라인 코드로 **굵게** 같은 형태를 표현할 수도 있습니다.
주의: 코드 블록 안의 문법은 일반 문장과 달리 이스케이프가 필요 없을 수 있습니다. 이미 코드 블록 안인데 백슬래시를 여러 번 추가하면 그 기호가 그대로 표시되어 오히려 설명이 어색해질 수 있습니다.
13. GitHub README에서 Markdown을 사용하는 이유
GitHub 저장소를 처음 방문하면 파일 목록 위나 아래에 프로젝트 소개글이 나타나는 경우가 많습니다.
그 설명이 README.md로 작성되어 있을 수 있습니다.
예를 들어 다음과 같이 준비할 수 있습니다.
# 나의 첫 AI 웹앱
공부하면서 만든 할 일 정리 도구입니다.
## 사용 방법
1. 프로젝트를 내려받습니다.
2. index.html을 엽니다.
3. 기능을 확인합니다.
## 주의사항
- 비밀번호와 API 키를 넣지 마세요.
- 중요한 파일은 백업해 두세요.
이 문서를 GitHub가 지원하는 방식으로 읽으면 제목과 목록이 보기 좋게 표시됩니다. README는 프로그램의 실행 파일이 아니라 설명 파일입니다. 프로젝트 작성자가 어떤 목적으로 만들었고 사용자는 어떤 절차를 따라야 하는지 안내합니다. 마크다운을 잘 활용하면 설치 안내·주의사항·출처를 유지하기 쉬운 형태로 정리할 수 있습니다.
14. Claude Code의 CLAUDE.md도 Markdown을 사용하나요?
네. Claude Code는 CLAUDE.md 같은 파일을 프로젝트 지침으로 사용할 수 있습니다.
예를 들어 문서에 다음과 같은 내용을 적을 수 있습니다.
# 프로젝트 규칙
## 문서 작성
- 초보자도 이해할 수 있는 한국어를 사용합니다.
- 파일을 수정하기 전에 변경 목적을 설명합니다.
## 검증
- 실제 테스트를 실행하지 않았다면 통과했다고 말하지 않습니다.
Claude Code가 이 파일을 읽도록 설정·동작하는 환경에서는 해당 문장을 프로젝트의 작업 지침으로 참고할 수 있습니다.
하지만 여기서 중요한 구분이 있습니다.
마크다운은 내용을 표시하는 문법이고, CLAUDE.md를 프로젝트 지침으로 읽을지 여부는 Claude Code의 기능입니다.
또한 CLAUDE.md에 “중요 파일을 지우지 마”라고 적는다고 운영체제의 파일 삭제 권한이 실제로 강제로 잠기는 것은 아닙니다.
강제적인 접근 제한이 필요하다면 실제 권한 모드·버전 관리·운영체제 권한을 따로 설정해야 합니다.
이 글은 CLAUDE.md 전체 기능을 설명하는 글이 아닙니다. 핵심은 어떤 AI 지침 파일에서든 Markdown 문법을 알아두면 제목과 목록을 읽기 쉽게 만들 수 있다는 점입니다.
15. Markdown과 HTML의 차이를 간단히 비교하면?
둘 다 문서 구조를 표현할 수 있지만 사용 범위가 다릅니다.
| 구분 | Markdown | HTML |
|---|---|---|
| 주 용도 | 읽기 쉬운 텍스트 문서 서식 | 웹문서의 구조 표현 |
| 제목 | # 제목 |
<h1>제목</h1> |
| 링크 | [이름](주소) |
<a href="주소">이름</a> |
| 쉬운 작성 | 몇 가지 기호만 익혀도 시작 | 태그와 속성 이해 필요 |
| 브라우저 표시 | 보통 Markdown 렌더러·변환 필요 | 웹브라우저가 직접 구조 해석 |
| 복잡한 배치 | 지원 확장에 따라 제약 | CSS와 함께 다양한 설계 가능 |
예를 들어 기술 문서를 작성할 때는 Markdown이 편리합니다. 반대로 사이트의 버튼 배치·상호작용·반응형 스타일을 세밀하게 조정하려면 HTML·CSS·JavaScript 등이 필요합니다. 중요한 점은 Markdown과 HTML이 서로 경쟁하는 완전히 대체 불가능한 기술은 아니라는 것입니다. Markdown을 HTML로 변환해 웹사이트에 표시할 수도 있고, 일부 Markdown 환경에서는 제한된 HTML 요소를 허용하기도 합니다. 단 원시 HTML 허용과 필터링 정책은 플랫폼마다 다릅니다. 인터넷에서 받은 Markdown 원고에 들어 있는 HTML·스크립트가 어떻게 처리되는지 확인해야 합니다.
16. AI가 쓴 Markdown을 Blogger에 바로 붙여 넣어도 되나요?
붙여 넣은 그대로 보기 좋게 나올 것이라고 보장할 수 없습니다. GitHub는 Markdown을 표시하도록 설계된 공간이지만, Blogger의 글 편집기는 HTML·시각적 편집 방식이 중심일 수 있습니다. 따라서 다음 순서가 안전합니다. 1단계. AI에게 Markdown 형식 원고를 받습니다. 2단계. 제목·소제목·목록·코드 예시가 올바른 구조인지 확인합니다. 3단계. 실제 사용할 편집기에서 Markdown을 지원하는지 확인합니다. 4단계. 직접 지원하지 않으면 신뢰할 수 있는 방법으로 HTML로 변환한 뒤 코드/링크/이미지 경로를 검사합니다. 5단계. 모바일 화면에서 표와 코드 블록의 가로 스크롤, 소제목 줄바꿈, 목차 들여쓰기 상태를 살펴봅니다. 6단계. 실제 이미지 파일과 대체 텍스트·저작권·게시 승인까지 확인한 뒤 발행 여부를 결정합니다. 중요: 코드 블록 안에 적힌 예제 HTML과 실제 게시물 HTML을 혼동하면 독자에게 보여 줄 코드가 실행되거나 화면 구조가 깨질 수 있습니다. 이 글은 Blogger 편집기에 직접 올려 보거나 게시 테스트를 수행한 결과가 아닙니다.
17. AI에게 Markdown 문서를 요청할 때의 프롬프트
코딩을 전혀 몰라도 AI에게 읽기 쉬운 문서를 부탁할 수 있습니다.
너는 Markdown 문서 작성을 돕는 편집자야.
목표:
- 비전공자가 읽을 수 있는 프로젝트 소개 문서를 만들고 싶어.
문서 조건:
1. 제목은 # 한 번으로 시작해.
2. 중요한 구역은 ## 소제목으로 나눠 줘.
3. 순서가 중요한 부분은 번호 목록을 써.
4. 순서가 중요하지 않은 부분은 - 목록으로 써.
5. 명령·파일 이름은 백틱 코드 서식으로 구분해.
6. 실제로 확인하지 못한 링크 주소를 만들지 마.
7. 실행하지 않은 명령이나 테스트는 '미실행'으로 표시해.
8. 내 계정·회사 정보·비밀번호·API 키를 포함하지 마.
9. 표·체크박스처럼 확장 문법이 필요한 부분은
GitHub에서만 지원될 수 있다고 설명해.
10. 마지막에 누락된 정보와 수동 검수할 곳을 적어.
출력:
\[Markdown 전체 원고\]
\[검수할 링크 목록\]
\[사실 확인이 필요한 내용\]
이 프롬프트는 단순히 AI에게 글의 형식과 검수 기준을 전달하는 예시입니다. AI가 만든 코드 블록이나 링크의 정확성은 사용자가 다시 확인해야 합니다.
18. 10분 안에 익히는 Markdown 실습
처음부터 복잡한 표나 HTML 변환을 익힐 필요는 없습니다.
0~2분: 텍스트 편집기에서 my-note.md라는 연습 파일을 만들어 봅니다.
2~4분: 맨 위에 # 오늘 배운 것을 적고, ## 연습 1이라는 소제목을 만듭니다.
4~6분: - 목록 세 개와 **중요** 표시를 추가합니다.
6~8분: [공식 GitHub 문서](https://docs.github.com/)처럼 실제 공식 주소를 넣습니다.
8~10분: GitHub 또는 Markdown 미리보기를 제공하는 편집기에서 제목·목록·링크가 어떻게 표시되는지 확인합니다.
추가로, 실습 후에는 원본 .md 파일과 화면에서 표시된 결과를 비교해 보세요.
이것이 마크다운의 가장 중요한 학습법입니다.
내가 적은 기호가 실제 문서에서 어떤 구조가 되는지 직접 보는 것.
참고한 공식 문서
자주 묻는 질문
Q1. Markdown이란 무엇인가요?
텍스트에 #, -, ** 같은 기호를 사용해 제목·목록·강조·링크·코드를 표현하는 간단한 문서 작성 문법입니다.
Q2. Markdown은 코딩을 알아야 쓸 수 있나요?
아닙니다. 제목·목록·굵게·링크 정도만 알아도 메모와 간단한 README를 작성할 수 있습니다.
Q3. .md 파일은 어떤 파일인가요?
일반적으로 Markdown 원문을 담은 텍스트 파일입니다. 프로그램 실행 파일이나 자동 공개 파일이라는 뜻은 아닙니다.
Q4. # 기호를 여러 개 붙이는 이유는 무엇인가요?
제목의 계층을 표현하기 위해서입니다. #는 가장 큰 수준, ##는 그 아래 소제목이며 보통 여섯 단계까지 사용할 수 있습니다.
Q5. 글자를 굵게 만들려면 어떻게 쓰나요?
일반적인 문법은 **중요한 문장**입니다. 마크다운을 지원하는 편집기에서 굵게 표시될 수 있습니다.
Q6. 하이퍼링크는 어떻게 만드나요?
[보이는 이름](https://example.com)처럼 작성합니다. 정확한 목적지 URL은 따로 확인해야 합니다.
Q7. 이미지도 Markdown으로 넣을 수 있나요?
를 이용합니다. 실제 이미지 파일이 있어야 하며 사용 권한도 확인해야 합니다.
Q8. 코드 블록은 무엇에 사용하나요?
명령이나 프로그램 코드를 일반 문장과 구분해 보기 좋게 표시합니다. 코드 블록 자체가 프로그램을 실행하는 것은 아닙니다.
Q9. GitHub 표와 체크박스 문법은 모든 Markdown 편집기에서 되나요?
그렇지 않습니다. GitHub Flavored Markdown 같은 확장 문법의 지원 여부에 따라 결과가 달라집니다.
Q10. Markdown과 HTML은 같은가요?
아닙니다. Markdown은 간단한 텍스트 문서 서식 문법이고 HTML은 웹문서 구조를 표현하는 마크업 언어입니다. Markdown을 HTML로 변환해 표시할 수 있습니다.
Q11. CLAUDE.md와 README.md에 같은 문법을 사용하나요?
둘 다 Markdown 텍스트를 작성할 수 있습니다. 다만 README는 주로 설명 문서이고 CLAUDE.md는 Claude Code에서 지침으로 읽을 수 있는 파일이므로 프로그램에서 맡는 역할은 다릅니다.
Q12. AI에게 Markdown으로 써 달라고 하면 사실도 자동 검증되나요?
아닙니다. Markdown은 문서의 형태만 정리합니다. AI가 만든 사실·출처·코드·URL은 별도로 검증해야 합니다.
마무리
Markdown은 복잡한 문서 작성 프로그램 없이도 제목·목록·링크·코드를 정리할 수 있는 가벼운 문법입니다.
처음에는 단 네 가지만 기억해도 충분합니다.
#는 제목, **는 강조, -는 목록, [이름](주소)는 링크입니다.
다음에 AI가 README.md나 CLAUDE.md를 만들어 줬다면 이상한 기호라고 지나치지 마세요.
기호는 문서의 구조를 알려 주는 안내판입니다.
더 복잡한 체크박스·표·HTML 변환은 기본 문법에 익숙해진 뒤에 배우고, 실제로 발행할 때는 그 플랫폼에서 어떻게 표시되는지 반드시 확인하면 됩니다.