기본 쓰기 및 서식 지정 구문

제목

제목을 만들려면 제목 텍스트 앞에 1~6 # 개의 기호를 추가합니다. 사용하는 수에 # 따라 머리글의 계층 수준과 서체 크기가 결정됩니다.

# A first-level heading
## A second-level heading
### A third-level heading

두 개 이상의 제목을 사용하는 경우 GitHub 파일 헤더 내에서 "개요" 메뉴 아이콘 옥티콘 "list-unordered" aria-label="목차" %}를 클릭하여 액세스할 수 있는 목차를 자동으로 생성합니다. 각 제목 제목은 목차에 나열되며 제목을 클릭하여 선택한 섹션으로 이동할 수 있습니다.

텍스트 스타일 지정

주석 필드 및 .md 파일에서 굵게, 기울집, 취소선, 아래 첨자 또는 위 첨자 텍스트로 강조를 나타낼 수 있습니다.

스타일	Syntax	키보드 단축키	Example	출력
Bold

          `** **` 또는 `__ __`| <c0>Command</c0><c1 /><c2>B</c2>(Mac) 또는 < >Ctrl</c3><c4 /><c5>B</c5>(Windows/Linux) | `**This is bold text**` | 
          **굵은 텍스트입니다.** |

| 이탤릭체 | * * 또는 _ _    | Command+I(Mac) 또는 Ctrl+I(Windows/Linux) | _This text is italicized_ | 이 텍스트는 기울임꼴로 표시되어 있습니다. | | 취소선 | ~~ ~~ 또는 ~ ~ | None | ~~This was mistaken text~~ | 잘못된 텍스트였습니다. | | 굵게 및 중첩된 기울임꼴 | ** ** 및 _ _ | None | **This text is _extremely_ important** | 이 텍스트는 매우 중요합니다. | | 모든 굵게 및 기울기 | *** *** | None | ***All this text is important*** | 이 모든 텍스트가 중요합니다. | | 아래 첨자 | <sub> </sub> | None | This is a <sub>subscript</sub> text | _{아래 첨}자 텍스트입니다. | | 위 첨자 | <sup> </sup> | None | This is a <sup>superscript</sup> text | ^{위 첨}자 텍스트입니다. | | 밑줄 | <ins> </ins> | None | This is an <ins>underlined</ins> text | 밑줄이 그은 텍스트입니다. |

인용문

를 사용하여 >텍스트를 인용할 수 있습니다.

Text that is not a quote

> Text that is a quote

따옴표 붙은 텍스트는 왼쪽에 세로선으로 들여쓰기되고 회색 형식으로 표시됩니다.

코드 인용

단일 백틱을 사용하여 문장 내에서 코드 또는 명령을 호출할 수 있습니다. 역따옴표 안의 텍스트는 서식이 지정되지 않습니다. Command+E(Mac) 또는 Ctrl 키를 누를 수도 있습니다. +E(Windows/Linux) 바로 가기 키로 Markdown 줄 내에 코드 블록의 백틱을 삽입합니다.

Use `git status` to list all new or modified files that haven't yet been committed.

코드나 문자를 고유한 블록으로 서식화하려면 세 개의 백틱을 사용합니다.

Some basic Git commands are:
```
git status
git add
git commit
```

자세한 내용은 코드 블록 만들기 및 강조 표시을(를) 참조하세요.

데이터 재사용 가능 사용자 설정 고정폭 글꼴 사용 가능 %}

지원되는 색 모델

문제, 끌어오기 요청, 토론에서 백틱을 사용하여 문장 안의 색상을 표시할 수 있습니다. 백틱 내에서 지원되는 색 모델은 색의 시각화를 표시합니다.

The background color is `#ffffff` for light mode and `#000000` for dark mode.

현재 지원되는 색 모델은 다음과 같습니다.

색깔	Syntax	Example	출력
16 진수	`#RRGGBB`	`#0969DA`
RGB	`rgb(R,G,B)`	`rgb(9, 105, 218)`
HSL	`hsl(H,S,L)`	`hsl(212, 92%, 45%)`

Links

링크 텍스트를 대괄호 [ ]로 묶은 다음 URL을 괄호로 래핑하여 인라인 링크를 만들 수 있습니다 ( ). 바로 가기 키 명령+K 를 사용하여 링크를 만들 수도 있습니다. 텍스트를 선택한 경우 클립보드의 URL을 붙여넣어 선택 영역에서 링크를 자동으로 만들 수 있습니다.

텍스트를 강조 표시하고 바로 가기 키 명령+V를 사용하여 Markdown 하이퍼링크를 만들 수도 있습니다. 텍스트를 링크로 바꾸려면 바로 가기 키 명령+Shift+V를 사용합니다.

This site was built using [GitHub Pages](https://pages.github.com/).

섹션 링크

제목이 있는 모든 섹션에 직접 연결할 수 있습니다. 렌더링된 파일에서 자동으로 생성된 앵커를 보려면 섹션 제목 위로 마우스를 가져가 아이콘을 표시하고 아이콘을 클릭하여 브라우저에 앵커를 표시합니다.

편집 중인 파일에서 제목에 대한 앵커를 결정해야 하는 경우 다음 기본 규칙을 사용할 수 있습니다.

• 문자는 소문자로 변환됩니다.
• 공백은 하이픈(-)으로 바뀝니다. 다른 공백 또는 문장 부호 문자는 모두 제거됩니다.
• 선행 및 후행 공백이 제거됩니다.
• 태그 서식이 제거되어 내용만 남게 됩니다(예: _italics_``italics).
• 제목에 대해 자동으로 생성된 앵커가 동일한 문서의 이전 앵커와 동일한 경우 하이픈과 자동 증가 정수를 추가하여 고유 식별자가 생성됩니다.

URI 조각의 요구 사항에 대한 자세한 내용은 RFC 3986: URI(Uniform Resource Identifier): Generic 구문, 섹션 3.5를 참조하세요.

아래 코드 블록은 렌더링된 콘텐츠의 제목에서 앵커를 생성하는 데 사용되는 기본 규칙을 보여 줍니다.

# Example headings

## Sample Section

## This'll be a _Helpful_ Section About the Greek Letter Θ!
A heading containing characters not allowed in fragments, UTF-8 characters, two consecutive spaces between the first and second words, and formatting.

## This heading is not unique in the file

TEXT 1

## This heading is not unique in the file

TEXT 2

# Links to the example headings above

Link to the sample section: [Link Text](#sample-section).

Link to the helpful section: [Link Text](#thisll-be-a-helpful-section-about-the-greek-letter-Θ).

Link to the first non-unique section: [Link Text](#this-heading-is-not-unique-in-the-file).

Link to the second non-unique section: [Link Text](#this-heading-is-not-unique-in-the-file-1).

상대 링크

렌더링된 파일에서 상대 링크 및 이미지 경로를 정의하여 판독기에서 리포지토리의 다른 파일로 이동할 수 있습니다.

상대 링크는 현재 파일을 기준으로 하는 링크입니다. 예를 들어 리포지토리의 루트에 추가 정보 파일이 있고 _docs/CONTRIBUTING.md_에 다른 파일이 있는 경우 추가 정보의 _CONTRIBUTING.md_에 대한 상대 링크는 다음과 같습니다.

[Contribution guidelines for this project](docs/CONTRIBUTING.md)

GitHub는 현재 위치한 분기에 따라 상대 링크 또는 이미지 경로를 자동으로 변환하므로 링크 또는 경로는 항상 작동합니다. 링크의 경로는 현재 파일을 기준으로 합니다. / 시작 링크는 리포지토리 루트를 기준으로 합니다. ./ 및 ../와 같은 모든 상대 링크 피연산자를 사용할 수 있습니다.

링크 텍스트는 한 줄이어야 합니다. 아래 예는 작동하지 않습니다.

[Contribution
guidelines for this project](docs/CONTRIBUTING.md)

상대 링크는 리포지토리를 복제하는 사용자가 사용하기 더 쉽습니다. 절대 링크는 리포지토리의 복제본에서 작동하지 않을 수 있습니다. 상대 링크를 사용하여 리포지토리 내의 다른 파일을 참조하는 것이 좋습니다.

사용자 지정 앵커

표준 HTML 앵커 태그(<a name="unique-anchor-name"></a>)를 사용하여 문서의 모든 위치에 대한 탐색 앵커 지점을 만들 수 있습니다. 모호한 참조를 방지하려면 특성 값에 접두사를 추가하는 등 앵커 태그에 고유한 명명 체계를 name 사용합니다.

앵커에 지정한 특성의 name 값을 사용하여 사용자 지정 앵커에 연결할 수 있습니다. 구문은 제목에 대해 자동으로 생성되는 앵커에 연결할 때와 정확히 동일합니다.

다음은 그 예입니다.

# Section Heading

Some body text of this section.

<a name="my-custom-anchor-point"></a>
Some text I want to provide a direct link to, but which doesn't have its own heading.

(… more content…)

[A link to that custom anchor](#my-custom-anchor-point)

줄 바꿈

리포지토리에서 문제, 끌어오기 요청 또는 토론을 작성하는 경우 GitHub는 줄 바꿈을 자동으로 렌더링합니다.

This example
Will span two lines

그러나 .md 파일에서 작성하는 경우 위의 예제는 줄 바꿈 없이 한 줄에 렌더링됩니다. .md 파일에서 줄 바꿈을 만들려면 다음 중 하나를 포함해야 합니다.

• 첫 번째 줄의 끝에 두 개의 공백을 포함합니다.

  This example  
  Will span two lines
  

• 첫 번째 줄의 끝에 백슬래시를 포함합니다.

  This example\
  Will span two lines
  

• 첫 번째 줄 끝에 HTML 단일 줄 바꿈 태그를 포함합니다.

  This example<br/>
  Will span two lines
  

두 줄 사이에 빈 줄을 두면 .md 파일과 Markdown이 모두 문제, 끌어오기 요청 및 토론에서 빈 줄로 구분된 두 줄을 렌더링합니다.

This example

Will have a blank line separating both lines

이미지

!을(를) 추가하여 이미지를 표시할 수 있습니다 . 을 입력하고 대체 텍스트를 줄 바꿈합니다 [ ]. 대체 텍스트는 이미지의 정보와 동일한 짧은 텍스트입니다. 그런 다음 이미지에 대한 링크를 괄호로 래핑합니다 ().

![Screenshot of a comment on a GitHub issue showing an image, added in the Markdown, of an Octocat smiling and raising a tentacle.](https://myoctocat.com/assets/images/base-octocat.svg)

GitHub에서는 이슈에 이미지 포함, 끌어오기 요청, 메모 및 .md 파일을 지원합니다. 리포지토리에서 이미지를 표시하거나, 온라인 이미지에 대한 링크를 추가하거나, 이미지를 업로드할 수 있습니다. 자세한 내용은 자산 업로드를 참조하세요.

다음은 상대 링크를 사용하여 이미지를 표시하는 몇 가지 예입니다.

컨텍스트	상대 링크

          `.md` 동일한 분기의 파일에서 | `/assets/images/electrocat.png` |

| 다른 분기의 .md 파일에서 | /../main/assets/images/electrocat.png | | 리포지토리의 이슈, 풀 리퀘스트 및 댓글에서 | ../blob/main/assets/images/electrocat.png?raw=true | | .md 다른 리포지토리의 파일에서 | /../../../../github/docs/blob/main/assets/images/electrocat.png | | 다른 리포지토리의 이슈, 끌어오기 요청 및 코멘트에서 | ../../../github/docs/blob/main/assets/images/electrocat.png?raw=true |

자세한 내용은 상대 링크를 참조하세요.

Picture 요소

          `<picture>` HTML 요소가 지원됩니다.

Lists

하나 이상의 텍스트 -*줄 앞에 순서가 지정되지 않은 목록을 만들 수 +있습니다.

- George Washington
* John Adams
+ Thomas Jefferson

목록의 순서를 지정하려면 각 줄 앞에 숫자를 줍니다.

1. James Madison
2. James Monroe
3. John Quincy Adams

중첩된 목록

하나 이상의 목록 항목을 다른 항목 아래에 포함시켜 중첩된 목록을 만들 수 있습니다.

GitHub의 웹 편집기 또는 Visual Studio Code와 같은 모노스페이스 글꼴을 사용하는 텍스트 편집기를 사용하여 중첩된 목록을 만들려면 목록을 시각적으로 정렬할 수 있습니다. 목록 표식 문자(- 또는 *)가 위 항목의 텍스트 첫 번째 문자 바로 아래에 놓일 때까지 중첩된 목록 항목 앞에 공백 문자를 입력합니다.

1. First list item
   - First nested list item
     - Second nested list item

모노스페이스 글꼴을 사용하지 않는 GitHub의 메모 편집기에서 중첩된 목록을 만들려면 중첩된 목록 바로 위에 있는 목록 항목을 확인하고 항목 내용 앞에 나타나는 문자 수를 계산할 수 있습니다. 그런 다음 중첩된 목록 항목 앞에 공백 문자 수를 입력합니다.

이 예제에서는 앞에 100. First list item5자(100. )가 있기 때문에 중첩된 목록 항목을 First list item 최소 5개의 공백으로 들여서 목록 항목 아래에 중첩된 목록 항목을 추가할 수 있습니다.

100. First list item
     - First nested list item

동일한 메서드를 사용하여 여러 수준의 중첩된 목록을 만들 수 있습니다. 예를 들어 첫 번째 중첩된 목록 항목에는 중첩된 목록 콘텐츠 ␣␣␣␣␣-␣앞에 7자(First nested list item)가 있으므로 두 번째 중첩된 목록 항목을 최소 2자 이상 들여쓰기해야 합니다(최소 9개의 공백).

100. First list item
     - First nested list item
       - Second nested list item

자세한 예제는 GitHub Flavored Markdown Spec 참조하세요.

작업 목록

작업 목록을 만들려면 하이픈과 공백 뒤에 [ ]이 오는 목록 항목의 접두사를 설정합니다. 작업을 완료로 표시하려면 [x]를 사용합니다.

- [x] #739
- [ ] https://github.com/octo-org/octo-repo/issues/740
- [ ] Add delight to the experience when all tasks are complete :tada:

작업 목록 항목 설명이 괄호로 시작하는 경우 다음을 사용하여 이 \스케이프해야 합니다.

- [ ] \(Optional) Open a followup issue

자세한 내용은 작업 목록 정보을(를) 참조하세요.

사람과 팀 언급하기

GitHub에서 사용자 이름 또는 팀 이름을 입력하여 @ 사용자 또는 팀을 언급할 수 있습니다. 그러면 알림이 트리거되고 대화에 주의가 집중됩니다. 사용자 이름 또는 팀 이름을 언급하는 댓글을 편집하는 경우에도 알림을 받게 됩니다. 알림에 대한 자세한 내용은 알림 정보을(를) 참조하세요.

@github/support What do you think about these updates?

부모 팀을 언급할 때 자식 팀의 구성원도 알림을 수신하여 여러 사용자 그룹과의 통신을 간소화합니다. 자세한 내용은 조직 팀 정보을(를) 참조하세요.

기호를 @ 입력하면 프로젝트의 사용자 또는 팀 목록이 표시됩니다. 입력할 때 목록이 필터링되므로 찾고 있는 사람 또는 팀의 이름을 찾으면 화살표 키를 사용하여 선택하거나 탭을 누르거나 입력하여 이름을 완성할 수 있습니다. 팀의 경우 입력하면 @organization/team-name 해당 팀의 모든 구성원이 대화에 가입됩니다.

자동 완성 결과는 리포지토리 공동 작업자 및 스레드의 다른 모든 참가자로 제한됩니다.

문제 참조 및 끌어오기 요청

를 입력하여 제안된 문제 목록을 표시하고 리포지토리 내에서 요청을 끌어올 수 있습니다 #. 문제를 입력하거나 끌어오기 요청 번호 또는 제목을 입력하여 목록을 필터링한 다음 탭을 누르거나 Enter 키를 눌러 강조 표시된 결과를 완료합니다.

자세한 내용은 자동 링크된 참조 및 URL을(를) 참조하세요.

외부 리소스 참조

리포지토리에 사용자 지정 자동 링크 참조가 구성된 경우 JIRA 문제 또는 Zendesk 티켓과 같은 외부 리소스에 대한 참조가 단축된 링크로 변환됩니다. 리포지토리에서 사용할 수 있는 자동 링크를 알아보려면 리포지토리에 대한 관리자 권한이 있는 사람에게 문의하세요. 자세한 내용은 외부 리소스를 참조하도록 자동 링크 구성을(를) 참조하세요.

자산 업로드

끌어서 놓기, 파일 브라우저에서 선택 또는 붙여넣기를 통해 이미지와 같은 자산을 업로드할 수 있습니다. 리포지토리의 문제, 끌어오기 요청, 메모 및 .md 파일에 자산을 업로드할 수 있습니다.

이모지 사용

글에 이모지, 콜론, 이모지 이름을 입력하여 :EMOJICODE:추가할 수 있습니다.

@octocat :+1: This PR looks great - it's ready to merge! :shipit:

입력 : 제안된 이모지 목록을 표시합니다. 입력할 때 목록이 필터링되므로 찾으려는 이모지가 발견되면 Tab 또는 Enter 키를 눌러 강조 표시된 결과를 완료합니다.

사용 가능한 이모지 및 코드의 전체 목록은 Emoji-Cheat-Sheet를 참조하세요.

Paragraphs

텍스트 줄 사이에 빈 줄을 남겨 새 단락을 만들 수 있습니다.

각주

이 대괄호 구문을 사용하여 콘텐츠에 각주를 추가할 수 있습니다.

Here is a simple footnote[^1].

A footnote can also have multiple lines[^2].

[^1]: My reference.
[^2]: To add line breaks within a footnote, add 2 spaces to the end of a line.  
This is a second line.

각주가 다음과 같이 렌더링됩니다.

경고

          **
          **
          **경고(설명선** 또는 **훈계**라고도 함)는 중요한 정보를 강조하는 데 사용할 수 있는 blockquote 구문을 기반으로 하는 Markdown 확장입니다. GitHub에서는 콘텐츠의 중요성을 나타내기 위해 고유한 색과 아이콘으로 표시됩니다.

경고는 사용자 성공에 중요한 경우에만 사용하고, 판독기 오버로드를 방지하기 위해 아티클당 하나 또는 두 개로 제한합니다. 또한 경고를 연속적으로 배치하지 않아야 합니다. 경고는 다른 요소 내에 중첩될 수 없습니다.

경고를 추가하려면 경고 유형을 지정하는 특수 블록 따옴표 줄을 사용하고, 그 다음에는 표준 블록호테의 경고 정보를 사용합니다. 5가지 유형의 경고를 사용할 수 있습니다.

> [!NOTE]
> Useful information that users should know, even when skimming content.

> [!TIP]
> Helpful advice for doing things better or more easily.

> [!IMPORTANT]
> Key information users need to know to achieve their goal.

> [!WARNING]
> Urgent info that needs immediate user attention to avoid problems.

> [!CAUTION]
> Advises about risks or negative outcomes of certain actions.

렌더링된 경고는 다음과 같습니다.

메모가 있는 콘텐츠 숨기기

GitHub에게 HTML 주석에 콘텐츠를 배치하여 렌더링된 Markdown에서 콘텐츠를 숨기도록 지시할 수 있습니다.

<!-- This content will not appear in the rendered Markdown -->

Markdown 서식 무시

GitHub에게 Markdown 문자 앞에 사용하여 \ Markdown 서식을 무시(또는 이스케이프)하도록 지시할 수 있습니다.

Let's rename \*our-new-project\* to \*our-old-project\*.

백슬라시에 대한 자세한 내용은 대담 파이어볼의 마크다운 구문을 참조하세요.

Markdown 렌더링 사용 안 함

마크다운 렌더링 비활성을 사용해 저장소 설정을 관리하십시오.

추가 읽기

•         [GitHub Flavored Markdown 사양](https://github.github.com/gfm/)
  

•         [AUTOTITLE](/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/about-writing-and-formatting-on-github)
  

•         [AUTOTITLE](/get-started/writing-on-github/working-with-advanced-formatting)
  

•         [AUTOTITLE](/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/quickstart-for-writing-on-github)