🚀 헷갈리지 않는 마크다운(Markdown) 핵심 가이드

🚀 헷갈리지 않는 마크다운(Markdown) 핵심 가이드

마크다운의 기본 마인드셋은 "원문 텍스트 상태에서도 읽기 쉽도록 최소한의 기호만 사용한다"입니다.
기호 뒤에는 반드시 띄어쓰기(공백) 1칸을 주는 규칙만 기억하면 99% 해결됩니다.

---

🌴 PART 1. 몸으로 익혀야 할 핵심 문법 5가지 (Big 5)

1. 제목 (Headings) : # 개수로 크기 조절

#의 개수가 늘어날수록 제목이 작아집니다.

2. 줄바꿈과 문단 (Paragraph & Line Break)

• 문단 나누기 (권장/보편적): 엔터를 2번 쳐서 사이에 빈 줄을 만듭니다.
• 강제 줄바꿈: 문장 맨 끝에 스페이스(공백) 2칸을 입력하고 엔터를 칩니다.

3. 강조 (Emphasis) : 텍스트 감싸기

• 굵게 (Bold): **내용**
• 기울임 (Italic): *내용*
• 취소선: ~~내용~~

4. 목록 (Lists) : - 와 1.

• 순서 없는 목록: - 작성 후 띄어쓰기 1칸
• 순서 있는 목록: 1. 2. 숫자 작성 후 띄어쓰기 1칸
• 하위 목록: Tab 키 또는 스페이스 2~4칸 들여쓰기

5. 코드 (Code) : 백틱( ` ) 활용

• 인라인 코드: 문장 중간 단어 강조 시 백틱 1개 (`code`)
• 코드 블록: 백틱 3개()로 감싸고 언어명 지정 (예: javascript)

---

🔥 PART 2. 가장 많이 하는 3대 실수 & 멘붕 방지법

❌ 실수 1. 가로선을 긋다가 글씨가 거대해지는 현상 (Setext Heading의 함정)

증상: 문장 아래에 ---를 썼더니 가로 구분선이 안 생기고 윗줄 글씨가 거대해짐!

💡 원인과 해결책

마크다운 파서는 텍스트 바로 아랫줄에 - 나 = 가 오면 "Setext Heading"이라는 밑줄 방식 제목으로 해석합니다.

• = 밑줄: <h1> (가장 큰 제목)
• - 밑줄: <h2> (두 번째로 큰 제목)

따라서 가로선(---)을 만들 때는 반드시 윗줄과의 사이에 빈 줄(엔터 1번 더)을 비워주어야 합니다!

💡 실무 꿀팁: 제목을 만들 때는 헷갈리는 밑줄 방식(Setext) 대신 오직 # (ATX Heading) 방식만 사용하시면 이러한 실수를 100% 예방할 수 있습니다!

---

❌ 실수 2. 기호 뒤 띄어쓰기(공백) 누락

• ❌ #오늘의 일기 $\rightarrow$ 기호가 반영되지 않고 #오늘의 일기 그대로 출력됨
• ✅ # 오늘의 일기 $\rightarrow$ 제목(H1)으로 정상 렌더링

마크다운의 모든 특수기호(\#, -, >, 1.) 뒤에는 반드시 스페이스 1칸이 들어가야 마크다운 문법으로 인식됩니다.

---

❌ 실수 3. 엔터를 한 번만 쳐서 줄바꿈이 안 됨

• ❌ 일반 텍스트 편집기처럼 엔터를 1번만 치면, 마크다운 렌더러는 문장이 이어진 것으로 간주하여 한 줄로 붙여서 출력합니다.
• ✅ 문단을 구분하고 싶다면 엔터를 2번 눌러 사이에 빈 줄을 만드는 습관을 들이는 것이 좋습니다.

---

🎨 PART 3. 문서를 돋보이게 하는 실무 필수 무기

1. 링크 & 이미지 (기억 공식)

"텍스트(말하고자 하는 바)가 먼저 [], URL(위치)은 뒤에 ()"

• 링크: [클릭할 텍스트](URL)
• 이미지: ![대체 텍스트](이미지URL) $\leftarrow$ 이미지는 링크 구조 맨 앞에 !만 붙임!

2. 인용구 (Blockquote) : >

• 다른 사람의 말, 메일 내용, 참고문헌이나 팁 상자를 만들 때 사용합니다.

3. 체크리스트 (Task List) : - [ ] / - [x]

---

💡 한눈에 정리하는 마크다운 3계명

1. 기호 뒤엔 반드시 스페이스 1칸! (# , - , > )
2. 요소(제목, 가로선, 목록, 코드) 사이에는 빈 줄(엔터 2번)을 두기!
3. 제목은 고민 없이 # 기호만 사용하기!