GitLab Flavored Markdown (GLFM)

링크를 만드는 두 가지 방법이 있습니다: 인라인 스타일과 참조 스타일. 예를 들어:

- 이 줄은 [인라인 스타일 링크](https://www.google.com)를 보여줍니다.
- 이 줄은 [동일한 디렉토리의 리포지토리 파일에 대한 링크](permissions.md)를 보여줍니다.
- 이 줄은 [파일을 한 단계 상위 디렉토리로 연결하는 상대적인 링크](../index.md)를 보여줍니다.
- 이 줄은 [제목 텍스트도 있는 링크](https://www.google.com "이 링크는 구글로 이동합니다!")를 보여줍니다!

헤딩 ID 앵커 사용:

- 이 줄은 다른 Markdown 페이지에서 섹션에 대한 링크를 [“#” 및 헤딩 ID](permissions.md#project-members-permissions)를 사용하여 보여줍니다.
- 이 줄은 같은 페이지의 다른 섹션에 대한 링크를 [“#” 및 헤딩 ID](#heading-ids-and-links)를 사용하여 보여줍니다.

참조를 사용:

- 이 줄은 [참조 스타일 링크, 아래 참조 참조하세요][임의의 대소문자 구분 없는 참조 텍스트]를 보여줍니다.
- 참조를 사용하여 [참조 스타일 링크 정의에 번호를 사용하세요, 아래 참조 참조하세요][1].
- 또는 비워두고 [링크 텍스트 자체를 사용하세요][], 아래 참조 참조하세요.

나중에 참조 링크를 사용할 수 있음을 보여주는 일부 텍스트.

[임의의 대소문자 구분 없는 참조 텍스트]: https://www.mozilla.org/en-US/
[1]: https://slashdot.org
[링크 텍스트 자체]: https://about.gitlab.com/

이 줄은 인라인 스타일 링크를 보여줍니다.
이 줄은 동일한 디렉토리의 리포지토리 파일에 대한 링크를 보여줍니다.
이 줄은 파일을 한 단계 상위 디렉토리로 연결하는 상대적인 링크를 보여줍니다.
이 줄은 제목 텍스트도 있는 링크를 보여줍니다!

헤딩 ID 앵커 사용:

이 줄은 다른 Markdown 페이지에서 섹션에 대한 링크를 “#” 및 헤딩 ID를 사용하여 보여줍니다.
이 줄은 같은 페이지의 다른 섹션에 대한 링크를 “#” 및 헤딩 ID를 사용하여 보여줍니다.

참조를 사용:

이 줄은 참조 스타일 링크, 아래 참조 참조하세요를 보여줍니다.
참조를 사용하여 참조 스타일 링크 정의에 번호를 사용하세요, 아래 참조 참조하세요.
또는 비워두고 링크 텍스트 자체를 사용하세요, 아래 참조 참조하세요.

나중에 참조 링크를 사용할 수 있음을 보여주는 일부 텍스트.

참고: 상대적인 링크는 위키 페이지의 프로젝트 파일을 참조하거나 프로젝트 파일의 위키 페이지를 참조하는 것을 허용하지 않습니다. 이유는 위키가 항상 GitLab의 별도 Git 리포지토리에 있기 때문입니다. 예를 들어, [참조 스타일 링크](style)가 위키 Markdown 파일 내에서 링크인 경우에만 링크를 wikis/style로 지정합니다.

URL 자동 링크

텍스트에 넣는 거의 모든 URL은 자동으로 링크됩니다:

- https://www.google.com
- https://www.google.com
- ftp://ftp.us.debian.org/debian/
- smb://foo/bar/baz
- irc://irc.freenode.net/
- http://localhost:3000

멀티미디어

이미지, 비디오, 오디오를 임베드합니다. 마크다운 구문을 사용하여 파일에 링크를 걸고 크기를 지정하고 인라인으로 표시할 수 있습니다. 서식 옵션을 사용하여 제목을 사용자 정의하고 너비와 높이를 지정하며 미디어가 렌더링된 출력에 어떻게 표시되는지 제어할 수 있습니다.

이미지

인라인 또는 참조 링크를 사용하여 이미지를 임베드합니다. 제목 텍스트를 보려면 이미지 위에 마우스를 올려두세요.

![대체 텍스트](img/markdown_logo.png "제목 텍스트")

참조 스타일:

![대체 텍스트1][로고]
[로고]: img/markdown_logo.png "제목 텍스트"

비디오

비디오 확장자가 있는 파일에 링크된 이미지 태그는 비디오 플레이어로 자동 변환됩니다. 유효한 비디오 확장자는 .mp4, .m4v, .mov, .webm, .ogv입니다:

다음은 예시 비디오입니다:

![샘플 비디오](img/markdown_video.mp4)

이미지 또는 비디오 크기 변경

이미지 지원 도입은 GitLab 15.7에서 되었습니다.
비디오 지원 도입은 GitLab 15.9에서 되었습니다.

이미지 또는 비디오의 너비와 높이를 제어할 수 있습니다. 이미지 뒤에 속성 목록을 추가하여 너비와 높이를 지정할 수 있습니다. 값은 기본적으로 px 단위의 정수여야 합니다. 또는 % 단위일 수 있습니다.

예시:

![대체 텍스트](img/markdown_logo.png "제목 텍스트"){너비=100 높이=100px}

![대체 텍스트](img/markdown_logo.png "제목 텍스트"){너비=75%}

{너비=100 높이=100px}

Markdown 대신 img HTML 태그를 사용하여 height 및 width 매개변수를 설정할 수도 있습니다.

GitLab 17.1 이후에 Markdown 텍스트 상자에 더 높은 해상도 PNG 이미지를 붙여넣으면 차원이 항상 추가됩니다. 차원은 자동적으로 레티나 (및 기타 높은 해상도) 디스플레이를 고려하여 자동으로 조정됩니다. 예를 들어, 144ppi의 이미지는 차원의 50%로 크기가 조정되며, 96ppi의 이미지는 차원의 75%로 크기가 조정됩니다.

오디오

GitLab에서 목록 렌더링된 이 주제를 확인하세요.

동영상과 유사하게 오디오 확장자를 가진 파일에 대한 링크 태그는 자동으로 오디오 플레이어로 변환됩니다. 유효한 오디오 확장자는 .mp3, .oga, .ogg, .spx, .wav입니다.

다음은 예시 오디오 클립입니다:

![샘플 오디오](img/markdown_audio.mp3)

순서가 있는 목록과 순서가 없는 목록을 생성할 수 있습니다.

순서가 있는 목록의 경우 각 줄의 시작에 1.과 공백을 추가하여 목록을 시작할 번호를 지정합니다. 첫 번째 숫자 이후에 사용하는 숫자는 중요하지 않습니다. 순서가 있는 목록은 자동으로 수직 순서에 따라 번호가 매겨지므로 동일한 목록의 모든 항목에 대해 1.을 반복하는 것이 일반적입니다. 숫자 1.이 아닌 다른 숫자로 시작하는 경우 해당 숫자를 첫 번째 숫자로 사용하고 거기서부터 번호를 매깁니다.

예시:

첫 번째 순서가 있는 목록 항목
다른 항목
   - 순서가 없는 하위 목록
실제 숫자는 중요하지 않으며, 숫자이기만 하면 됩니다.
순서가 있는 하위 목록
다음 순서가 있는 하위 목록 항목
또 다른 항목

첫 번째 순서가 있는 목록 항목
다른 항목
- 순서가 없는 하위 목록.
실제 숫자는 중요하지 않으며, 숫자이기만 하면 됩니다.
1. 순서가 있는 하위 목록
2. 다음 순서가 있는 하위 목록 항목
그리고 또 다른 항목.

순서가 없는 목록의 경우 각 줄의 시작에 -, *, 또는 +와 공백을 추가합니다. 동일한 목록 내에서 문자를 혼용하지 않아야 합니다.

순서가 없는 목록은 다음을 수행할 수 있습니다:

- 사용
- 빼기

그들은 또한:

- 사용
- 별표

심지어:

- 사용
- 플러스

순서가 없는 목록은 다음을 수행할 수 있습니다:

사용
빼기

그들은 또한:

사용
별표

심지어:

사용
플러스

목록 항목에 여러 단락이 포함된 경우, 각 후속 단락은 목록 항목 텍스트의 시작과 동일한 수준으로 들여쓰기되어야 합니다.

예시:

1. 첫 번째 순서가 있는 목록 항목

   첫 번째 항목의 두 번째 단락.

1. 다른 항목

첫 번째 순서가 있는 목록 항목
첫 번째 항목의 두 번째 단락.
다른 항목

첫 번째 항목의 단락이 올바른 수의 공백으로 들여쓰기되지 않은 경우 해당 단락은 목록 외부에 나타납니다. 목록 항목 아래에 올바른 수의 공백을 사용하여 올바르게 들여쓰기해야 합니다.

예를 들어:

1. 첫 번째 순서가 있는 목록 항목

(첫 번째 항목의 단락.)

1. 다른 항목

첫 번째 순서가 있는 목록 항목

(첫 번째 항목의 단락.)

다른 항목

순서가 없는 목록 항목의 첫 번째 하위 항목이 1.로 시작하지 않는 경우, 선행하는 공백 행이 있어야 합니다.

좋은 예시

- 순서가 없는 목록 항목

  5. 첫 번째 순서가 있는 목록 항목

나쁜 예시

- 순서가 없는 목록 항목 5. 첫 번째 순서가 있는 목록 항목

CommonMark는 순서가 있는 목록 항목과 순서가 없는 목록 항목 사이의 공백 라인을 무시하고 하나의 목록으로 간주합니다. 항목들은 하나의loose 목록의 일부로 간주됩니다. 각 목록 항목은 단락 태그로 둘러싸이므로 단락 간 간격과 여백이 있습니다. 이로써 각 항목 간에 추가 공간이 있는 것처럼 보입니다.

예를 들어:

- 첫 번째 목록 항목
- 두 번째 목록 항목

- 다른 목록

CommonMark는 빈 줄을 무시하고 이를 단락 간 간격이 있는 한 목록으로 렌더링합니다.

작업 목록

GitLab 15.3에서 도입된 적용되지 않는 확인란

GitLab에서 이 주제를 렌더링된 이 주제를 확인하세요.

Markdown이 지원되는 곳이라면 작업 목록을 추가할 수 있습니다.

이슈, 병합 요청, 에픽, 및 코멘트에서는 상자를 선택할 수 있습니다.
다른 모든 장소에서는 상자를 선택할 수 없습니다. 수동으로 Markdown을 편집하여 대괄호에 x를 추가하거나 제거해야 합니다.

완료 및 미완료 외에도 작업은 적용되지 않음 상태일 수도 있습니다. 이슈, 병합 요청, 에픽, 또는 코멘트에서 적용되지 않는 확인란을 선택해도 효과가 없습니다.

작업 목록을 만들려면 순서가 있는 목록 또는 순서가 없는 목록의 형식을 따라야 합니다:

- [x] 완료된 작업
- [~] 적용되지 않는 작업
- [ ] 미완료된 작업
  - [x] 하위 작업 1
  - [~] 하위 작업 2
  - [ ] 하위 작업 3

1. [x] 완료된 작업
1. [~] 적용되지 않는 작업
1. [ ] 미완료된 작업
   1. [x] 하위 작업 1
   1. [~] 하위 작업 2
   1. [ ] 하위 작업 3

테이블에 작업 목록을 포함하려면, HTML 목록 태그 또는 HTML 테이블을 사용하세요.

인용구

GitLab에서 이 주제를 렌더링된 이 주제를 확인하세요.

인용구를 사용하여 사이드 노트와 같은 정보를 강조할 수 있습니다. 이를 생성하려면 인용구의 줄을 >로 시작합니다:

> 인용구를 사용하여 회신 텍스트와 유사하게 만들 수 있습니다.
> 이 줄은 동일한 인용문의 일부입니다.

인용문 분리.

> 이 매우 긴 줄은 여전히 올바르게 인용되며 줄 바꿈될 때 유지됩니다. 모두에게 실제로 줄 바꿈이 되도록이 줄이 충분히 길어지도록 계속 작성하세요. 또한 인용구에서 *Markdown*을 **사용**할 수 있습니다.

인용구를 사용하여 회신 텍스트와 유사하게 만들 수 있습니다. 이 줄은 동일한 인용문의 일부입니다.

인용문 분리.

이 매우 긴 줄은 여전히 올바르게 인용되며 줄 바꿈될 때 유지됩니다. 모두에게 실제로 줄 바꿈이 되도록이 줄이 충분히 길어지도록 계속 작성하세요. 또한 인용구에서 Markdown을 사용할 수 있습니다.

다중 행 인용구

>>>로 감싼 다중 행 블록 인용구를 생성하세요:

> > > 다른 곳에서 메시지를 붙여넣는 경우

여러 줄에 걸친 경우,

모든 줄에 수동으로 `>`를 추가하지 않고도 인용할 수 있습니다!

> > >

코드 스팬 및 블록

코드로 처리되어야 하는 내용을 강조하세요.

인라인 코드는 단일 역따옴표 `로 서식이 지정됩니다:

인라인 `코드`는 `역따옴표를 사용`해서 처리됩니다.

인라인 코드는 역따옴표를 사용해서 처리됩니다.

더 큰 코드 예제에 유사한 효과를 얻으려면 다음을 수행할 수 있습니다:

세 개의 역따옴표 ( `` `)로 전체 코드 블록을 감싸세요.
- 여는 집합과 닫는 집합이 동일하면 세 개 이상의 역따옴표를 사용할 수 있습니다. 예를 들어 코드 블록에서 제안을 포함하거나 그 반대 경우에는 여러 개의 역따옴표를 사용할 수 있습니다.
세 개의 물결 표시로 전체 코드 블록을 감싸세요.
네 개 이상의 공백으로 들여쓰기합니다.

```python
def function():
    # 들여쓰기가 코드 블록에서 정상적으로 작동함
    s = "파이썬 코드"
    print s
```

    4개의 공백을 사용하면
    3개의 역따옴표를 사용한 것과 같습니다.

~~~
물결 표시도 괜찮습니다.
~~~

위의 세 가지 예제는 다음과 같이 렌더링됩니다:

def function():
    # 들여쓰기가 코드 블록에서 정상적으로 작동함
    s = "파이썬 코드"
    print s

4개의 공백을 사용하면
3개의 역따옴표를 사용한 것과 같습니다.

물결 표시도 괜찮습니다.

구문 강조

GitLab은 더 다채로운 구문 강조를 위해 루비 루주(Rouge) 라이브러리를 사용합니다. 지원되는 언어 목록은 Rouge 프로젝트 위키를 참조하세요. 구문 강조는 코드 블록에서만 지원되므로 인라인 코드는 강조할 수 없습니다.

코드 블록을 감싸고 구문 강조를 적용하려면 코드 시작 부분에 코드 언어를 추가하세요. 세 개의 역따옴표 ( `` ) 또는 세 개의 물결 표시 (~~~`) 뒤에 코드 언어를 추가하세요:

```javascript
var s = "JavaScript 구문 강조";
alert(s);
```

```python
def function():
    # 들여쓰기가 코드 블록에서 정상적으로 작동함
    s = "Python 구문 강조"
    print s
```

```ruby
require 'redcarpet'
markdown = Redcarpet.new("Hello World!")
puts markdown.to_html
```

```
언어가 지정되지 않았으므로 구문 강조가 없습니다.
s = "이 줄에는 구문 강조가 표시되지 않습니다."
하지만 <b>tag</b>을 넣어 봅시다.
```

위의 네 가지 예제는 다음과 같이 렌더링됩니다:

var s = "JavaScript 구문 강조";
alert(s);

def function():
    # 들여쓰기가 코드 블록에서 정상적으로 작동함
    s = "Python 구문 강조"
    print s

require 'redcarpet'
markdown = Redcarpet.new("Hello World!")
puts markdown.to_html

언어가 지정되지 않았으므로 구문 강조가 없습니다.
s = "이 줄에는 구문 강조가 표시되지 않습니다."
하지만 <b>tag</b>을 넣어 봅시다.

다이어그램 및 플로차트

텍스트로부터 다이어그램을 생성하는 것이 가능합니다:

Mermaid
PlantUML
Kroki을 사용하여 다양한 다이어그램을 생성합니다.

위키에서는 다이어그램.net 편집기로 생성된 다이어그램을 추가하고 수정할 수 있습니다.

Mermaid

GitLab 16.0에서 Entity Relationship 다이어그램 및 마인드 맵의 지원이 추가되었습니다.

더 많은 세부 정보를 위해 공식 페이지를 방문하세요. Mermaid 라이브 편집기를 사용하여 Mermaid 코드의 문제를 식별하고 해결하세요. 그것을 사용하여 다이어그램의 문제를 식별하고 해결하세요.

다이어그램이나 플로차트를 생성하려면 mermaid 블록 내에 텍스트를 작성하세요:

```mermaid
graph TD;
  A-->B;
  A-->C;
  B-->D;
  C-->D;
```

graph TD; A-->B; A-->C; B-->D; C-->D;

하위 그래프를 포함할 수도 있습니다:

```mermaid
graph TB
  SubGraph1 --> SubGraph1Flow

  subgraph "SubGraph 1 Flow"
    SubGraph1Flow(SubNode 1)
    SubGraph1Flow -- Choice1 --> DoChoice1
    SubGraph1Flow -- Choice2 --> DoChoice2
  end

  subgraph "Main Graph"
    Node1[Node 1] --> Node2[Node 2]
    Node2 --> SubGraph1[Jump to SubGraph1]
    SubGraph1 --> FinalThing[Final Thing]
  end
```

graph TB SubGraph1 --> SubGraph1Flow subgraph "SubGraph 1 Flow" SubGraph1Flow(SubNode 1) SubGraph1Flow -- Choice1 --> DoChoice1 SubGraph1Flow -- Choice2 --> DoChoice2 end subgraph "Main Graph" Node1[Node 1] --> Node2[Node 2] Node2 --> SubGraph1[Jump to SubGraph1] SubGraph1 --> FinalThing[Final Thing] end

PlantUML

GitLab.com에서는 PlantUML 통합이 활성화되어 있습니다. GitLab의 셀프매너지 설치에서 PlantUML을 사용할 수 있도록 하려면 GitLab 관리자는 이를 활성화해야 합니다.

Kroki

GitLab에서 Kroki를 사용하려면 GitLab 관리자가 이를 활성화해야 합니다. 자세한 내용은 Kroki 통합 페이지를 참조하세요.

수학

LaTeX 호환 펜싱은 GitLab 15.4에서 markdown_dollar_math이라는 플래그로 도입되었으며, 기본적으로 비활성화되어 있습니다. GitLab.com에서 활성화되어 있습니다.
LaTeX 호환 펜싱은 GitLab 15.8에서 일반적으로 사용 가능해졌습니다. 기능 플래그 markdown_dollar_math가 제거되었습니다.

LaTeX 구문으로 작성된 수식은 KaTeX으로 렌더링됩니다. KaTeX는 LaTeX의 일부만 지원합니다. 이 구문은 AsciiDoc 위키와 :stem: latexmath를 사용하는 파일에서도 작동합니다. 자세한 내용은 AsciiDoctor 사용자 매뉴얼을 참조하세요.

악의적인 활동을 방지하기 위해 GitLab은 인라인 수학 인스턴스를 최대 50개까지만 렌더링합니다. 렌더링 시간을 기준으로 수학 블록의 수도 제한됩니다. 제한을 초과하면 GitLab이 나머지 수학 인스턴스를 텍스트로 렌더링합니다. 위키와 저장소 파일에는 이러한 제한이 없습니다.

딸기 사이에 있는 더블 더블 더블 더블 더블 더블 더블 더블

테이블

테이블을 생성할 때:

첫 번째 줄에는 헤더가 있으며, 이는 파이프 문자(|)로 구분됩니다.
두 번째 줄은 헤더와 셀을 구분합니다.
- 셀은 비어 있는 공백, 하이픈 및 가로 정렬에만 콜론을 추가할 수 있습니다(선택 사항).
- 각 셀에는 하이픈이 하나 이상 있어야 하지만, 셀에 더 많은 하이픈을 추가해도 셀의 렌더링이 변경되지 않습니다.
- 하이픈, 공백 또는 콜론 이외의 콘텐츠는 허용되지 않습니다.
세 번째 및 이후의 줄에는 셀 값이 포함됩니다.
- Markdown에서 여러 줄에 걸쳐있는 셀을 가질수는 없습니다. 한 줄만 유지해야 하지만 매우 길 수 있습니다. 필요한 경우 HTML <br> 태그를 사용하여 강제로 새 줄을 만들 수 있습니다.
- 셀 크기는 서로 일치할 필요는 없습니다. 유연하게 사용할 수 있지만 파이프(|)로 구분해야 합니다.
- 빈 셀이 있을 수 있습니다.
열 너비는 셀의 내용을 기반으로 동적으로 계산됩니다.
텍스트 내에 파이프 문자(|)를 사용하려면 이스케이프 처리해야 합니다.

예시:

| header 1 | header 2 | header 3 |
| -------- | -------- | -------- |
| cell 1   | cell 2   | cell 3   |
| cell 4   | cell 5   | cell 6   |
| cell 7   | cell 8   | cell 9   |

header 1	header 2	header 3
cell 1	cell 2	cell 3
cell 4	cell 5	cell 6
cell 7	cell 8	cell 9

정렬

또한 두 번째 행에 있는 “대시” 라인의 양쪽에 콜론(:)을 추가하여 텍스트의 정렬을 선택할 수 있습니다. 이는 각 열의 모든 셀에 영향을 미칩니다:

| Left Aligned | Centered | Right Aligned |
| :----------- | :------: | ------------: |
| Cell 1       |  Cell 2  |        Cell 3 |
| Cell 4       |  Cell 5  |        Cell 6 |

Left Aligned	Centered	Right Aligned
Cell 1	Cell 2	Cell 3
Cell 4	Cell 5	Cell 6

실제 GitLab에서는 Chrome과 Firefox에서 헤더는 항상 왼쪽 정렬이며 Safari에서는 중앙 정렬됩니다.

여러 줄을 갖는 셀