5분 만에 배우는 Markdown

여러분은 아마 모르고 Markdown을 사용한 적이 있을 것입니다. Slack 메시지에서 **굵게**를 입력한 적이 있나요? GitHub에서 README를 작성한 적이 있나요? Reddit 게시물에 서식을 지정한 적이 있나요? 그것이 Markdown입니다.

Markdown은 간단한 기호를 사용하여 일반 텍스트에 서식을 지정하는 가벼운 방법입니다. 굵게, 기울임, 제목, 목록을 위해 도구 모음 버튼을 클릭하는 대신 원하는 서식을 나타내는 몇 개의 문자를 입력합니다. 2004년 John Gruber와 Aaron Swartz가 만들었으며, 이후 개발자, 작가, 웹에서 텍스트를 다루는 모든 사람의 기본 서식 언어가 되었습니다.

Markdown이 존재하는 이유

Markdown 이전에는 웹용 텍스트에 서식을 지정하려면 HTML을 작성해야 했습니다. 단어를 굵게 하려면 <strong>bold</strong>를 입력했습니다. 목록을 만들려면 <ul><li>item</li></ul>이 필요했습니다. HTML은 강력하지만 장황하고 원시 형태로는 읽기 어렵습니다.

Markdown은 사람이 읽을 수 있는 축약형을 제공하여 이를 해결합니다. 원시 텍스트는 렌더링되기 전에도 읽기 쉽습니다. 서식이 적용된 출력은 깔끔하고 전문적입니다. 읽기 쉬운 소스 텍스트와 세련된 출력, 두 가지 장점을 모두 얻을 수 있습니다.

핵심 구문

Markdown을 생산적으로 사용하기 위해 알아야 할 모든 것입니다.

제목

해시 기호(#)를 사용하여 제목을 만듭니다. 해시가 많을수록 작은 제목입니다.

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

굵게와 기울임

텍스트를 별표나 밑줄로 감쌉니다:

**굵은 텍스트**
*기울임 텍스트*
***굵고 기울인 텍스트***

목록

순서 없는 목록은 대시, 별표, 더하기 기호를 사용합니다. 순서 있는 목록은 숫자를 사용합니다.

- 첫 번째 항목
- 두 번째 항목
- 세 번째 항목

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

링크

대괄호로 텍스트를, 소괄호로 URL을 감쌉니다:

[여기를 클릭](https://example.com)

이미지

링크와 비슷하지만 앞에 느낌표를 붙입니다:

![대체 텍스트](image-url.jpg)

인용문

꺾쇠 기호를 사용합니다:

> 이것은 인용문입니다. 들여쓰기되고 다른 스타일로 표시됩니다.

코드

인라인 코드에는 백틱을, 코드 블록에는 삼중 백틱을 사용합니다:

`print()` 함수를 사용하여 텍스트를 출력합니다.

여러 줄 코드 블록에는 선택적 언어 식별자와 함께 삼중 백틱을 사용합니다:

```python
def hello():
    print("Hello, world!")
```

수평선

세 개 이상의 대시, 별표, 또는 밑줄:

---

표

파이프와 대시를 사용합니다:

| 이름 | 역할 | 위치 |
| --- | --- | --- |
| Alice | 개발자 | 베를린 |
| Bob | 디자이너 | 런던 |

Markdown이 사용되는 곳

Markdown은 어디에나 있습니다:

소프트웨어 개발

• GitHub, GitLab, Bitbucket: README, 이슈, 풀 리퀘스트, 문서가 모두 Markdown으로 작성됩니다.
• Stack Overflow: 질문과 답변이 Markdown 서식을 사용합니다.
• 코드 문서: 많은 문서 생성기(Docusaurus, MkDocs, Jekyll)가 Markdown을 소스 형식으로 사용합니다.

커뮤니케이션

• Slack: 메시지 서식에 Markdown의 하위 집합을 지원합니다.
• Discord: 굵게, 기울임, 코드 블록 등에 Markdown을 사용합니다.
• Reddit: 게시물과 댓글이 Markdown으로 서식 지정됩니다.

글쓰기와 출판

• 블로그: 많은 정적 사이트 생성기가 Markdown 파일을 콘텐츠 소스로 사용합니다.
• 책: 여러 출판 도구가 Markdown 원고를 허용합니다.
• 노트: Obsidian, Notion, Bear, Typora 같은 앱이 Markdown을 중심으로 구축되었습니다.

문서

• 기술 문서: API 문서, 사용자 가이드, 위키가 일반적으로 Markdown을 사용합니다.
• 내부 지식 베이스: 많은 팀이 Markdown 기반 위키를 사용합니다.

Markdown의 종류

알아두면 좋은 점이 있습니다: Markdown에는 여러 "종류(flavor)"가 있습니다. 핵심 구문은 어디서나 동일하지만 일부 플랫폼은 확장 기능을 추가합니다:

차이는 대부분 고급 기능에 있습니다. 기본(제목, 굵게, 기울임, 목록, 링크, 이미지, 코드)은 어디서나 동일하게 작동합니다.

흔한 실수

빈 줄 누락

Markdown은 많은 요소 앞뒤에 빈 줄이 필요합니다. 제목 앞에는 빈 줄이 필요합니다. 목록 앞뒤에는 빈 줄이 필요합니다. 이 빈 줄을 잊는 것이 렌더링 문제의 가장 흔한 원인입니다.

일관되지 않은 목록 마커

같은 목록에서 -, *, +를 혼합하면 예상치 못한 렌더링이 발생할 수 있습니다. 하나를 골라 일관되게 사용하세요.

기호 뒤 공백

일부 Markdown 프로세서는 제목의 # 뒤와 목록의 - 뒤에 공백이 필요합니다. 안전을 위해 항상 공백을 포함하세요.

# 올바른 제목
#잘못된 제목

- 올바른 목록 항목
-잘못된 목록 항목

Markdown을 배울 가치가 있는 이유

Markdown은 5분이면 배우고 시간이 지남에 따라 몇 시간을 절약합니다. 한번 알면:

• GitHub에서 아름답게 렌더링되는 문서를 작성할 수 있습니다
• Slack과 Discord에서 마우스 없이 메시지 서식을 지정할 수 있습니다
• 앱 간에 이동 가능한 구조화된 노트를 작성할 수 있습니다
• 일반 텍스트 파일에서 블로그 게시물과 웹 콘텐츠를 만들 수 있습니다
• 형식 호환성 문제 없이 텍스트 기반 문서에서 협업할 수 있습니다

투자 대비 보상 비율은 기술 세계 전체에서 최고 수준입니다.

지금 바로 Markdown으로 글쓰기를 시작하세요:

• Markdown으로 글쓰기 및 미리 보기
• Markdown 미리 보기 도구

무료, 브라우저에서, 타이핑하면서 실시간 미리 보기.