마크다운이란 무엇이며 어떻게 사용하나요?

마크다운은 일반 텍스트 편집기를 사용하여 포맷된 텍스트를 만들 수 있는 가벼운 마크업 언어입니다. 2004년에 John Gruber가 처음 만든 마크다운은 문서 작성, 블로깅, 메모 작성, 심지어 웹사이트 및 애플리케이션의 콘텐츠 포맷에도 널리 사용됩니다.

이 글에서는 마크다운이 무엇인지, 어디에 일반적으로 사용되는지, 그리고 가장 필수적인 포맷 기능을 적용하는 방법을 다룰 것입니다.

마크다운이란?

마크다운은 웹에서 텍스트 스타일을 지정하는 간단한 방법입니다. 복잡한 HTML 태그나 WYSIWYG 편집기를 사용하는 대신, 마크다운을 사용하면 사용자가 읽기 쉬운 일반 텍스트 구문을 사용하여 작성한 다음 HTML로 변환할 수 있습니다.

예를 들어, 텍스트를 굵게 만들려면 **이렇게**와 같이 이중 별표로 묶고, 목록을 만들려면 대시 또는 숫자를 사용할 수 있습니다.

마크다운은 단순성과 유연성의 균형으로 인해 인기가 높으며, 기술자와 비기술자 모두에게 접근하기 쉽습니다.

마크다운의 일반적인 사용 사례

마크다운은 일반 텍스트에 스타일을 지정하거나 구조화해야 하는 많은 곳에서 사용됩니다.

기술 문서

개발자와 기술 작가는 읽기 쉽고 Git과 같은 버전 제어 시스템과 쉽게 통합할 수 있기 때문에 마크다운을 사용하여 문서를 작성하는 경우가 많습니다.

GitHub의 README 파일

GitHub는 README 파일과 문서에 마크다운을 기본적으로 지원합니다. 프로젝트를 소개하고 설명하는 기본 형식입니다.

블로깅 및 콘텐츠 작성

Jekyll, Hugo, Next.js와 같은 최신 정적 사이트 생성기들은 콘텐츠 생성을 위해 마크다운을 지원합니다. 또한 Ghost 및 Dev.to와 같은 블로깅 플랫폼에서도 사용됩니다.

메모 앱

Obsidian, Notion (부분 지원), Bear와 같은 앱에서는 사용자가 쉬운 포맷을 위해 마크다운 구문을 사용하여 메모를 작성할 수 있습니다.

이메일 포맷 및 메시지

일부 이메일 클라이언트 및 메시징 플랫폼 (예: Slack 및 Discord)에서는 굵게, 기울임꼴 또는 코드 블록과 같은 기본 포맷을 위해 부분적인 마크다운 구문을 허용합니다.

기본 마크다운 구문 및 사용 방법

마크다운 구문은 간단하고 사람이 읽기 쉽습니다. 다음은 가장 일반적인 요소입니다.

제목

# 기호를 사용하여 제목을 만듭니다. # 기호의 수는 제목 수준에 해당합니다.

# H1 - 메인 제목
## H2 - 섹션 제목
### H3 - 하위 섹션 제목

강조

기울임꼴 또는 굵게로 텍스트를 강조할 수 있습니다.

*기울임꼴* 또는 _기울임꼴_
**굵게** 또는 __굵게__
***굵게 및 기울임꼴*** 또는 ___굵게 및 기울임꼴___

목록

마크다운은 순서가 없는 목록과 순서가 있는 목록을 모두 지원합니다.

  • 순서가 없는 목록:

    - 항목 1
    - 항목 2
      - 하위 항목
    
  • 순서가 있는 목록:

    1. 첫 번째 항목
    2. 두 번째 항목
       1. 중첩된 항목
    

링크

하이퍼링크를 추가하려면 텍스트에는 대괄호를 사용하고 URL에는 괄호를 사용합니다.

[OpenAI 방문](https://www.openai.com)

이미지

이미지는 링크와 동일한 구문을 사용하지만 느낌표로 시작합니다.

![대체 텍스트](https://example.com/image.png)

인용 블록

인용 블록을 만들려면 줄 앞에 >를 붙입니다.

> 이것은 인용 블록입니다.

코드 및 코드 블록

인라인 코드의 경우 텍스트를 백틱으로 묶습니다.

`console.log()` 함수를 사용하세요.

여러 줄 코드 블록의 경우 삼중 백틱을 사용합니다.

```javascript
function greet(name) {
  return `Hello, ${name}`;
}
```

수평선

세 개 이상의 대시, 별표 또는 밑줄을 사용하여 수평선을 만듭니다.

---

테이블

마크다운 테이블은 파이프와 하이픈을 사용합니다.

| 구문   | 설명     |
| ------ | -------- |
| 헤더   | 제목     |
| 셀     | 콘텐츠   |

마크다운 작성 팁

  • 마크다운 미리보기 도구(예: VS Code, Typora 또는 StackEdit)를 사용하여 출력을 즉시 확인합니다.
  • 긴 문서를 작성할 때는 적절한 제목으로 섹션을 구성하세요.
  • 명확성을 유지하기 위해 일관된 서식을 사용합니다.
  • HTML 스타일 <!-- 주석 -->을 사용하여 최종 출력에 표시되지 않는 메모를 남깁니다.