Markdown이란 무엇일까요?

12분

Markdown은 HTML의 오버헤드로부터 콘텐츠 작성자를 보호하여 콘텐츠 편집에 대한 lean 접근 방식을 제공하는 생성 언어입니다. HTML은 콘텐츠를 의도한 방식 그대로 렌더링할 때 대단히 효과적이지만, 많은 용량을 차지하며 소량만 사용하더라도 작업하기가 쉽지 않습니다. Markdown은 HTML의 뛰어난 콘텐츠 설명 기능과 일반 텍스트 편집의 간편함을 적절히 제공합니다.

이 단원에서는 Markdown의 구조와 구문에 대해 설명합니다. GitHub 기능을 콘텐츠와 통합할 수 있도록 하는 구문 확장인 GFM(GitHub 지정 Markdown)의 특징도 살펴봅니다.

참고

이 단원의 목적은 Markdown에 관한 기본 정보를 제공하는 것입니다. 보다 자세히 알아보려면 이 모듈 요약 단원의 Markdown 구문 설명 및 GitHub 지정 Markdown 사양 문서를 참조하세요.

텍스트 강조

GitHub에서 통신하는 가장 중요한 부분은 일반적으로 텍스트 자체이지만 텍스트의 일부가 다른 부분보다 더 중요하다는 것을 어떻게 보여 주나요?

텍스트에 기울임꼴을 적용해도 좋고 대상 텍스트 주위에 단일 별표(*)나 단일 밑줄(_)을 배치해도 됩니다. 열었던 것과 동일한 문자로 강조를 닫아야 합니다. 별표와 밑줄 사용을 결합하는 방법에 주의합니다. 다음은 몇 가지 예입니다.

This is *italic* text.
This is also _italic_ text.

이것은 기울임꼴을 적용한 텍스트입니다. 이것은 ‘기울임꼴’ 텍스트입니다.

별표 두 개(**)나 밑줄 두 개(__)를 사용하여 굵은 텍스트를 만듭니다.

This is **bold** text.
This is also __bold__ text.

이것은 굵게 표시한 텍스트입니다. 이것은 굵은 텍스트입니다.

다른 강조 표시를 함께 사용해도 됩니다.

_This is **italic and bold** text_ using a single underscore for italic and double asterisks for bold.
__This is bold and *italic* text__ using double underscores for bold and single asterisks for italic.

이것은 기울임꼴에 단일 밑줄을 사용하고 굵은 텍스트에 이중 별표를 사용하는 ‘기울임꼴 텍스트와 굵은 텍스트’입니다. 이것은 굵은 텍스트에 이중 밑줄을 사용하고 기울임꼴에 단일 별표를 사용하는 굵은 텍스트와 ‘기울임꼴’ 텍스트입니다.

리터럴 별표를 사용하려면 GFM에서 앞에 백슬래시(\)인 이스케이프 문자를 사용합니다. 이 예제에서는 밑줄과 별표가 출력에 표시됩니다.

\_This is all \*\*plain\*\* text\_.

_이것은 모두 **일반** 텍스트입니다_.

머리글 선언

HTML은 <h1> 태그 같은 콘텐츠 제목을 제공합니다. Markdown에서 이러한 제목은 # 기호를 이용해 지원됩니다. 1~6의 각 제목 수준에 대해 #을 하나만 사용해야 합니다.

###### This is H6 text

H6 텍스트입니다.

이미지 및 사이트 링크

이미지와 사이트 링크는 유사한 구문을 사용합니다.

![Link an image.](/learn/azure-devops/shared/media/mara.png)

[Link to Microsoft Training](/training)

Microsoft 교육 링크

목록 만들기

순서가 지정되거나 지정되지 않은 목록을 정의할 수 있습니다. 들여쓰기를 이용해 중첩된 항목을 정의할 수도 있습니다.

순서가 지정된 목록은 숫자로 시작합니다.
순서가 지정되지 않은 목록은 별표 또는 대시(-)를 사용할 수 있습니다.

다음은 순서가 지정된 목록을 만드는 Markdown입니다.

1. First
1. Second
1. Third

결과:

첫 번째

두 번째

세 번째

다음은 순서가 지정되지 않은 목록을 만드는 Markdown입니다.

- First
  - Nested
- Second
- Third

처음

중첩됨

두 번째

세 번째

표 구성

열 구분을 위한 파이프(|)와 이전 행을 헤더로 지정하기 위한 대시(-)의 조합을 사용하여 표를 구성할 수 있습니다.

First|Second
-|-
1|2
3|4

첫 번째 두 번째

1 2

3 4

첫 번째	두 번째
1	2
3	4

텍스트 인용 표시

보다 큼(>) 문자를 사용하여 블록 인용을 만들 수 있습니다.

> This is quoted text.

이것은 따옴표로 묶은 텍스트입니다.

인라인 HTML로 부족한 부분 채우기

Markdown에서 지원하지 않는 HTML 시나리오가 있다면 해당 HTML을 인라인으로 사용하면 됩니다.

Here is a<br />line break

이것은
줄 바꿈입니다

코드 작업

Markdown은 백틱(`) 문자로 구분하는 인라인 코드 블록 처리를 위한 기본 동작을 제공합니다. 텍스트에 이 문자를 추가하면 코드로 렌더링됩니다.

This is `code`.

이것은 code입니다.

여러 줄에 걸쳐 있는 코드 세그먼트가 있다면 앞뒤에 백틱 3개(```)를 사용하여 울타리를 친 코드 블록을 만들 수 있습니다.

```markdown
var first = 1;
var second = 2;
var sum = first + second;
```

var first = 1;
var second = 2;
var sum = first + second;

GFM은 인기 언어에 구문 강조 기능을 제공하여 이러한 지원을 더욱 강화합니다. 첫 번째 틱 시퀀스의 일부로 언어를 지정하기만 하면 됩니다.

```javascript
var first = 1;
var second = 2;
var sum = first + second;
```

var first = 1;
var second = 2;
var sum = first + second;

문제 및 끌어오기 요청 교차 링크

GFM은 문제 및 끌어오기 요청 링크를 쉽게 생성할 수 있도록 다양한 짧은 코드(shortcode) 형식을 지원합니다. 이 작업을 수행하는 가장 쉬운 방법은 #ID 형식을 사용하는 것입니다(예: #3602). 사용자가 긴 링크를 붙여넣으면 GitHub는 이 형식에 맞게 자동으로 조정합니다. 다른 도구를 이용하거나 다른 프로젝트/분기를 지정하고 싶을 때는 다른 규칙을 따를 수도 있습니다.

참조 형식	원시 참조	짧은 링크
이슈 또는 끌어오기 요청 URL	`https://github.com/desktop/desktop/pull/3602`	#3602
`#` 및 이슈 또는 끌어오기 요청 번호	#3602	#3602
`GH-` 및 이슈 또는 끌어오기 요청 번호	GH-3602	GH-3602
`Username/Repository#` 및 이슈 또는 끌어오기 요청 번호	desktop/desktop#3602	desktop/desktop#3602

자세한 내용은 이 모듈 요약 단원의 자동 연결 참조 및 URL 문서를 참조하세요.

특정 커밋 연결

해당 ID로 붙여넣거나 단순히 SHA(Secure Hash Algorithm)를 사용하여 커밋에 연결할 수 있습니다.

참조 형식	원시 참조	짧은 링크
커밋 URL	https://github.com/desktop/desktop/commit/
8304e9c271a5e5ab4fda797304cd7bcca7158c87	8304e9c
SHA	8304e9c271a5e5ab4fda797304cd7bcca7158c87	8304e9c
User@SHA	desktop@8304e9c271a5e5ab4fda797304cd7bcca7158c87	desktop@8304e9c
Username/Repository@SHA	desktop/desktop@8304e9c271a5e5ab4fda797304cd7bcca7158c87	desktop/desktop@8304e9c

사용자 및 팀 멘션

GitHub 사용자 이름 앞에 @ 기호를 입력하면 해당 사용자에게 해당 주석에 대한 알림이 전송됩니다. 개인을 언급하기 때문에 이것은 "@mention"이라고 합니다. 조직 내 팀을 @mention할 수도 있습니다.

@githubteacher

@githubteacher

작업 목록 추적

다음 구문을 사용하여 문제 또는 끌어오기 요청 내에서 작업 목록을 만들 수 있습니다. 이러한 목록을 문제 또는 끌어오기 요청의 본문에서 사용하면 진행률을 추적하는 데 도움이 됩니다.

- [x] First task
- [x] Second task
- [ ] Third task

GitHub 작업 목록의 스크린샷

슬래시 명령

슬래시 명령을 사용하면 복잡한 Markdown을 만드는 데 필요한 입력을 줄여 시간을 절약할 수 있습니다.

슬래시 명령이 지원되는 이슈, 끌어오기 요청 또는 토론의 설명 또는 주석 필드에 슬래시 명령을 사용할 수 있습니다.

명령	설명
`/code`	Markdown 코드 블록을 삽입합니다. 언어를 선택합니다.
`/details`	축소 가능한 세부 정보 영역을 삽입합니다. 제목과 콘텐츠를 선택합니다.
`/saved-replies`	저장된 회신을 삽입합니다. 사용자 계정에 대해 저장된 회신 중에서 선택합니다. 저장된 회신에 `%cursor%`를 추가하면 슬래시 명령이 커서를 해당 위치에 배치합니다.
`/table`	Markdown 테이블을 삽입합니다. 열 및 행 수를 선택합니다.
`/tasklist`	작업 목록을 삽입합니다. 이 슬래시 명령은 이슈 설명에서만 작동합니다.
`/template`	리포지토리의 모든 템플릿을 표시합니다. 삽입할 템플릿을 선택합니다. 이 슬래시 명령은 이슈 템플릿 및 끌어오기 요청 템플릿에서 작동합니다.