제목
제목을 만들려면 제목 텍스트 앞에 1~6개의 # 기호를 추가합니다. 사용하는 #의 수에 따라 제목의 계층 구조 수준과 글꼴 크기가 결정됩니다.
# A first-level heading
## A second-level heading
### A third-level heading
두 개 이상의 제목을 사용하는 경우 GitHub는 파일 헤더 내에서 을(를) 클릭하여 액세스할 수 있는 목차를 자동으로 생성합니다. 각 제목은 목차에 나열되며, 제목을 클릭하면 선택한 섹션으로 이동할 수 있습니다.
텍스트 스타일 지정
주석 필드 및 .md
파일에서 굵게, 기울임꼴 또는 취소선 텍스트로 강조를 나타낼 수 있습니다.
스타일 | 구문 | 바로 가기 키 | 예시 | 출력 |
---|---|---|---|---|
Bold | ** ** 또는 __ __ | Command+B(Mac) 또는 Ctrl+B(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
따옴표로 묶인 텍스트는 다른 형식의 색으로 들여쓰기 됩니다.
Note
대화를 볼 때 텍스트를 강조 표시한 다음 R을 입력하면 주석의 텍스트를 자동으로 인용할 수 있습니다. 을(를) 클릭하고 회신 인용을 클릭하면 전체 주석을 인용할 수 있습니다. 단축키에 대한 자세한 내용은 "바로 가기 키"을 참조하세요.
인용 코드
단일 백틱을 사용하여 문장 내에서 코드 또는 명령을 표시할 수 있습니다. 백틱 내의 텍스트는 서식이 지정되지 않습니다. 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
```
자세한 내용은 "코드 블록 만들기 및 강조 표시"을(를) 참조하세요.
코드 조각과 테이블을 자주 편집하는 경우 GitHub의 모든 주석 필드에서 고정 너비 글꼴을 사용하도록 설정하면 도움이 될 수 있습니다. 자세한 정보는 "GitHub에서의 쓰기 및 서식 지정 정보"을(를) 참조하세요.
지원되는 색 모델
이슈, 끌어오기 요청 및 토론에서 백틱을 사용하여 문장 내의 색을 나타낼 수 있습니다. 백틱 내에서 지원되는 색 모델은 색의 시각화를 표시합니다.
The background color is `#ffffff` for light mode and `#000000` for dark mode.
현재 지원되는 색 모델은 다음과 같습니다.
색 | 구문 | 예시 | 출력 |
---|---|---|---|
HEX | `#RRGGBB` | `#0969DA` | |
RGB | `rgb(R,G,B)` | `rgb(9, 105, 218)` | |
HSL | `hsl(H,S,L)` | `hsl(212, 92%, 45%)` |
Note
- 지원되는 색 모델에서 백틱 내에는 선행 또는 후행 공백이 있을 수 없습니다.
- 색 시각화는 이슈, 끌어오기 요청 및 토론에서만 지원됩니다.
링크
링크 텍스트를 대괄호 [ ]
로 묶은 다음 URL을 괄호 ( )
로 묶어 인라인 링크를 만들 수 있습니다. 바로 가기 키 명령+K를 사용하여 링크를 만들 수도 있습니다. 텍스트를 선택한 경우 클립보드의 URL을 붙여넣어 선택 영역에서 링크를 자동으로 만들 수 있습니다.
텍스트를 강조 표시하고 Command+V를 사용하여 Markdown 하이퍼링크를 만들 수도 있습니다. 단축키인 명령어+Shift+V를 사용하면 텍스트를 링크로 전환할 수 있습니다.
This site was built using [GitHub Pages](https://pages.github.com/).
Note
GitHub은(는) 주석에 유효한 URL이 작성되면 자동으로 링크를 만듭니다. 자세한 내용은 "자동 링크된 참조 및 URL"을(를) 참조하세요.
섹션 링크
제목이 있는 모든 섹션에 직접 연결할 수 있습니다. 렌더링된 파일에서 자동으로 생성된 앵커를 보려면 섹션 제목 위로 마우스를 가져가 아이콘을 표시하고 아이콘을 클릭하여 브라우저에 앵커를 표시합니다.
편집 중인 파일에서 제목에 대한 앵커를 결정해야 하는 경우 다음 기본 규칙을 사용할 수 있습니다.
- 문자는 소문자로 변환됩니다.
- 스페이스는 하이픈(
-
)으로 바뀝니다. 다른 공백 또는 문장 부호 문자는 모두 제거됩니다. - 선행 및 후행 공백은 제거됩니다.
- 마크업 서식이 제거되고 내용만 남습니다(예:
_italics_
는italics
가 됩니다). - 제목에 대해 자동으로 생성된 앵커가 동일한 문서의 이전 앵커와 동일한 경우 하이픈과 자동 증가 정수를 추가하여 고유 식별자가 생성됩니다.
URI 조각의 요구 사항에 대한 자세한 내용은 RFC 3986: URI(Uniform Resource Identifier): 제네릭 구문, 섹션 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).
Note
제목을 편집하거나 "동일한" 앵커를 사용하여 제목 순서를 변경하는 경우 앵커가 변경될 때 해당 제목의 링크도 업데이트해야 합니다.
상대 링크
렌더링된 파일에서 상대 링크 및 이미지 경로를 정의하여 판독기에서 리포지토리의 다른 파일로 이동할 수 있습니다.
상대 링크는 현재 파일을 기준으로 하는 링크입니다. 예를 들어 리포지토리의 루트에 추가 정보 파일이 있고 _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
특성 값에 접두사를 추가하는 등 앵커 태그에 고유한 명명 체계를 사용합니다.
Note
사용자 지정 앵커는 문서 개요/목차에 포함되지 않습니다.
앵커에 지정한 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)
Tip
사용자 지정 앵커는 자동 제목 링크의 자동 이름 지정 및 번호 매기기 동작으로 간주되지 않습니다.
이미지
!를 추가하고 [ ]
에 대체 텍스트를 넣어 이미지를 표시할 수 있습니다. 대체 텍스트는 이미지의 정보와 동일한 짧은 텍스트입니다. 그런 다음 이미지에 대한 링크를 괄호 ()
에 넣습니다.
![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
파일에 이미지를 포함하는 기능을 지원합니다. 리포지토리에 있는 이미지를 표시하거나, 온라인 이미지에 대한 링크를 추가하거나, 이미지를 업로드할 수 있습니다. 자세한 내용은 “자산 업로드”를 참조하세요.
Note
리포지토리에 있는 이미지를 표시하려면 절대 링크 대신 상대 링크를 사용해야 합니다.
다음은 상대 링크를 사용하여 이미지를 표시하는 몇 가지 예입니다.
Context | 상대 링크 |
---|---|
동일한 분기의 .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 |
Note
위 표에 표시된 두 개의 마지막 상대 링크는 뷰어에게 해당 이미지가 포함된 프라이빗 리포지토리에 대한 최소 읽기 권한이 있는 경우에만 프라이빗 리포지토리의 이미지에 대해 작동합니다.
자세한 내용은 “상대 링크”를 참조하세요.
이미지가 표시되는 테마 지정
prefers-color-scheme
미디어 기능과 함께 HTML <picture>
요소를 사용하여 Markdown에서 이미지가 표시되는 테마를 지정할 수 있습니다. 밝은 색 모드와 어두운 색 모드를 구분하므로 두 가지 옵션을 사용할 수 있습니다. 이러한 옵션을 사용하여 어둡거나 밝은 배경에 최적화된 이미지를 표시할 수 있습니다. 이는 투명한 PNG 이미지에 특히 유용합니다.
예를 들어 다음 코드는 밝은 테마의 태양 이미지와 어두운 테마의 달을 표시합니다.
<picture>
<source media="(prefers-color-scheme: dark)" srcset="https://user-images.githubusercontent.com/25423296/163456776-7f95b81a-f1ed-45f7-b7ab-8fa810d529fa.png">
<source media="(prefers-color-scheme: light)" srcset="https://user-images.githubusercontent.com/25423296/163456779-a8556205-d0a5-45e2-ac17-42d089e3c3f8.png">
<img alt="Shows an illustrated sun in light mode and a moon with stars in dark mode." src="https://user-images.githubusercontent.com/25423296/163456779-a8556205-d0a5-45e2-ac17-42d089e3c3f8.png">
</picture>
URL에 추가된 조각(#gh-dark-mode-only
또는 #gh-light-mode-only
)을 사용하여 테마를 기준으로 이미지를 지정하는 이전 방법은 닫기이며 위에서 설명한 새 방법을 위해 제거될 예정입니다.
목록
하나 이상의 텍스트 행 앞에 -, *, 또는 +을(를) 입력하여 순서가 지정되지 않은 목록을 만들 수 있습니다.
- 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
Note
웹 기반 편집기에서 원하는 줄을 먼저 강조 표시한 다음 Tab 또는 Shift+Tab을 각각 사용하여 하나 이상의 텍스트 줄을 들여쓰거나 내어쓸 수 있습니다.
고정 폭 글꼴을 사용하지 않는 GitHub의 주석 편집기에서 중첩된 목록을 만들려면, 중첩된 목록 바로 위에 있는 목록 항목을 확인하고 항목의 내용 앞에 표시되는 문자 수를 계산할 수 있습니다. 그런 다음 중첩된 목록 항목 앞에 해당 수만큼의 공백 문자를 입력합니다.
이 예제에서는 First list item
앞에 5개 문자(100.
)가 있으므로 중첩된 목록 항목을 최소 5개 공백으로 들여써서 목록 항목 100. First list item
아래에 중첩된 목록 항목을 추가할 수 있습니다.
100. First list item
- First nested list item
동일한 방법을 사용하여 여러 수준의 중첩된 목록을 만들 수 있습니다. 예를 들어 첫 번째 중첩된 목록 항목에는 중첩된 목록 내용 First nested list item
앞에 일곱 자의 문자(␣␣␣␣␣-␣
)가 있으므로, 두 번째 중첩된 목록 항목은 첫 번째 목록 항목보다 두 자 이상 더 들여써야 하며, 이 경우에는 최소 9 개의 공백이 필요합니다.
100. First list item
- First nested list item
- Second nested list item
더 많은 예제는 GitHub Flavored Markdown 사양을 참조하세요.
작업 목록
작업 목록을 만들려면 하이픈과 공백 뒤에 [ ]
이 오는 목록 항목의 접두사를 설정합니다. 작업을 완료로 표시하려면 [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에서 사람 또는 팀을 멘션할 수 있습니다. 그러면 알림이 트리거되고 해당 사용자의 주의를 대화에 집중시킬 수 있습니다. 또한 사용자 이름 또는 팀 이름을 멘션하는 메모를 편집하는 경우에도 해당 사용자는 알림을 받게 됩니다. 알림에 대한 자세한 내용은 “알림 정보”을 참조하세요.
Note
리포지토리에 대한 읽기 권한이 있는 경우에만 멘션에 대한 알림을 받으며 리포지토리를 조직에서 소유한 경우 해당 사용자는 조직의 구성원이 됩니다.
@github/support What do you think about these updates?
부모 팀을 멘션할 경우 자식 팀의 구성원도 알림을 수신하므로, 여러 사용자 그룹과의 통신이 간소화됩니다. 자세한 내용은 "팀 정보"을(를) 참조하세요.
@ 기호를 입력하면 프로젝트에 사용자 또는 팀 목록이 표시됩니다. 입력할 때 목록이 필터링되므로 찾고 있는 사용자나 팀의 이름을 찾았으면 화살표 키를 사용하여 선택하고 Tab 또는 Enter 키를 눌러 이름을 완성할 수 있습니다. 팀의 경우 @organization/team-name을 입력하면 해당 팀의 모든 구성원이 대화를 구독하게 됩니다.
자동 완성 결과는 리포지토리 협력자 및 스레드의 다른 참가자로 제한됩니다.
이슈 및 끌어오기 요청 참조
#을 입력하여 리포지토리 내에서 제안된 이슈 및 끌어오기 요청 목록을 표시할 수 있습니다. 이슈, 끌어오기 요청 번호 또는 제목을 입력하여 목록을 필터링한 다음, Tab 또는 Enter 키를 눌러 강조 표시된 결과를 완성합니다.
자세한 내용은 "자동 링크된 참조 및 URL"을(를) 참조하세요.
외부 리소스 참조
리포지토리에 사용자 지정 자동 링크 참조가 구성된 경우 JIRA 문제 또는 Zendesk 티켓과 같은 외부 리소스에 대한 참조가 단축된 링크로 변환됩니다. 리포지토리에서 사용할 수 있는 자동 링크를 알아보려면 리포지토리에 대한 관리자 권한이 있는 사람에게 문의하세요. 자세한 내용은 "외부 리소스를 참조하도록 자동 링크 구성"을(를) 참조하세요.
자산 업로드 중
끌어서 놓기, 파일 브라우저에서 선택, 붙여넣기 등을 통해 이미지와 같은 자산을 업로드할 수 있습니다. 리포지토리의 이슈, 끌어오기 요청, 주석, .md
파일에 자산을 업로드할 수 있습니다.
이모지 사용
:EMOJICODE:
, 콜론, 이모지 이름 순으로 입력하여 글에 이모지를 추가할 수 있습니다.
@octocat :+1: This PR looks great - it's ready to merge! :shipit:
:을 입력하면 제안된 이모지 목록이 표시됩니다. 입력할 때 목록이 필터링되므로 원하는 이모지를 찾았으면 Tab 또는 Enter 키를 눌러 강조 표시된 결과를 완성합니다.
사용 가능한 이모지 및 코드의 전체 목록을 보려면 Emoji-Cheat-Sheet를 확인하세요.
단락
텍스트 줄 사이에 빈 줄을 두어 새 단락을 만들 수 있습니다.
각주
이 대괄호 구문을 사용하여 콘텐츠에 각주를 추가할 수 있습니다.
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, prefix new lines with 2 spaces.
This is a second line.
각주가 다음과 같이 렌더링됩니다.
Note
Markdown에서 각주의 위치는 각주가 렌더링될 위치에 영향을 주지 않습니다. 각주에 대한 참조 바로 뒤에 각주를 작성할 수 있으며, 각주는 여전히 Markdown의 하단에 렌더링됩니다. 각주는 wiki에서 지원되지 않습니다.
경고
경고는 중요한 정보를 강조하는 데 사용할 수 있는 blockquote 구문을 기반으로 한 Markdown 확장입니다. GitHub에서는 콘텐츠의 중요도를 나타내기 위해 고유한 색과 아이콘으로 표시됩니다.
경고는 사용자 성공에 중요한 경우에만 사용하고, 판독기 오버로드를 방지하기 위해 문서당 하나 또는 두 개로 제한합니다. 또한 경고를 연속적으로 배치하지 않아야 합니다. 경고는 다른 요소 내에 중첩될 수 없습니다.
경고를 추가하려면 경고 유형을 지정하는 특수 blockquote 줄을 사용하고, 그 다음에는 표준 blockquote의 경고 정보를 사용합니다. 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.
렌더링된 경고는 다음과 같습니다.
주석이 있는 콘텐츠 숨기기
HTML 주석에 콘텐츠를 배치하여 렌더링된 Markdown에서 콘텐츠를 숨기도록 GitHub에 지시할 수 있습니다.
<!-- This content will not appear in the rendered Markdown -->
Markdown 서식 무시
Markdown 문자 앞에 \를 사용하여 Markdown 형식을 무시(또는 이스케이프)하도록 GitHub에 지시할 수 있습니다.
Let's rename \*our-new-project\* to \*our-old-project\*.
백슬래시에 대한 자세한 내용은 Daring Fireball의 "Markdown: 구문"을 참조하세요.
Note
Markdown 서식은 문제 또는 끌어오기 요청의 제목에서 무시되지 않습니다.
Markdown 렌더링 사용 안 함
Markdown 파일을 볼 때 파일 위쪽의 코드를 클릭하여 Markdown 렌더링을 사용하지 않도록 설정하고 대신 파일의 원본을 볼 수 있습니다.
Markdown 렌더링을 사용하지 않도록 설정하면 렌더링된 Markdown 파일을 볼 때 사용할 수 없는 줄 연결과 같은 원본 보기 기능을 사용할 수 있습니다.