Markdown: 한 번 쓰고 어디든 게시

문서를 써야 해. 또는 README. 또는 블로그 포스트. 또는 포맷팅이 있는 Slack 메시지.

HTML은 과함. Word 문서는 어디서나 작동하지 않아. 일반 텍스트는 포맷팅이 없어.

Markdown이 스위트 스팟에 있어. 간단한 문법, 일반 텍스트로 읽기 쉬워, 필요할 때 HTML로 변환돼.

기본

# 헤딩 1
## 헤딩 2
### 헤딩 3

**굵게** 그리고 *기울임*

- 불릿 포인트
- 또 다른 포인트
  - 중첩된 포인트

1. 번호 매긴 리스트
2. 두 번째 항목

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

![이미지 alt 텍스트](image.jpg)

필요한 대부분이 이거야.

코드 포맷팅

백틱으로 인라인 코드: console.log('hello')

트리플 백틱으로 코드 블록:

function hello() {
  return 'world';
}

구문 강조를 위해 여는 백틱 뒤에 언어 지정.

테이블

| 이름  | 역할       |
|-------|------------|
| Alice | 개발자     |
| Bob   | 디자이너   |

테이블은 타이핑이 까다로워. 대부분의 에디터에 단축키가 있어.

인용구

> 이건 인용이야.
> 여러 줄에 걸칠 수 있어.

콜아웃, 인용, 중요한 텍스트 강조에 써.

Markdown이 작동하는 이유

읽기 쉬운 소스. 렌더링 없이도 Markdown은 읽기 쉬워. **굵게**는 명백히 굵게야.

이식 가능. GitHub, Notion, Slack, Reddit, 수많은 정적 사이트 생성기. 한 번 쓰고 어디든 붙여넣어.

버전 관리 친화적. 일반 텍스트야. Git diff가 의미 있어. 병합이 작동해.

미래 증명. 독점 포맷 없음. 콘텐츠가 영원히 접근 가능해.

플레이버 차이

GitHub Flavored Markdown (GFM)이 체크박스, 테이블, 구문 강조를 추가해.

CommonMark는 표준화 노력이야. 대부분의 플랫폼이 지원해.

어떤 플랫폼은 추가를 더해: Obsidian엔 위키링크, Notion엔 데이터베이스.

최대 이식성을 위해 기본 문법을 고수해.

흔한 실수

빈 줄 잊기. 문단은 사이에 빈 줄이 필요해. 없으면 모든 게 함께 이어져.

헤딩 뒤 공백. #헤딩은 작동 안 해. # 헤딩은 돼. 공백 주목.

깨진 링크. https://를 빼먹으면 어떤 플랫폼에서 링크가 실패해.

alt 텍스트 없는 이미지. ![](image.jpg)는 작동하지만 접근성이 떨어져. 설명 추가해.

작성 팁

구조를 위해 헤딩 써. 독자가 읽기 전에 스캔해.

문단을 짧게 유지해. 여백이 가독성을 도와.

게시 전 미리보기해. 렌더러마다 엣지 케이스를 다르게 다뤄.

---

Markdown은 글쓰기에서 마찰을 제거해. 기본을 한 번 배우고 어디서나 써. 단순함이 기능이야.