InfoGrab DocsInfoGrab Docs

위키 전용 Markdown

요약

다음 주제에서는 위키 내부의 링크가 어떻게 동작하는지 설명합니다. 위키 페이지로 링크할 때는 페이지 이름 대신 페이지 슬러그를 사용합니다. 위키는 표준 Markdown 링크 외에도 위키 페이지 간 링크를 간단하게 만드는 특수 위키 스타일 링크 구문을 지원합니다.

링크#

다음 주제에서는 위키 내부의 링크가 어떻게 동작하는지 설명합니다.

위키 페이지로 링크할 때는 페이지 이름 대신 페이지 슬러그를 사용합니다. 페이지 슬러그는 페이지 제목을 URL에 적합한 형태로 바꾼 것으로, 공백은 하이픈으로 바뀌고 특수 문자는 제거되거나 변환됩니다. 예를 들어 제목이 "How to Use GitLab" 인 페이지의 슬러그는 How-to-Use-GitLab 입니다.

위키 스타일 링크#

위키는 표준 Markdown 링크 외에도 위키 페이지 간 링크를 간단하게 만드는 특수 위키 스타일 링크 구문을 지원합니다.

이중 대괄호 구문#

이중 대괄호를 사용해 위키 페이지로 링크할 수 있습니다.

[[Home]]

이 구문은 슬러그가 Home 인 위키 페이지로 연결되는 링크를 만듭니다. 페이지가 없으면 링크를 선택했을 때 해당 페이지를 만들 수 있습니다.

페이지 슬러그에 하이픈이 포함된 경우, 링크는 슬러그를 그대로 표시합니다.

[[Home-page-new-slug]]

이 경우 링크 텍스트로 Home-page-new-slug가 표시됩니다.

사용자 지정 텍스트가 있는 이중 대괄호 구문#

표시하려는 제목이 페이지 슬러그와 다르면 파이프(|) 문자를 사용해 표시 텍스트와 페이지 슬러그를 구분합니다.

[[How to use GitLab|how-to-use-gitlab]]

이 경우 링크 텍스트로 "How to use GitLab" 이 표시되고, 슬러그가 how-to-use-gitlab 인 페이지로 연결됩니다.

하이픈이 포함된 슬러그를 가진 페이지에 더 읽기 쉬운 제목을 붙일 때도 이 구문을 사용할 수 있습니다.

[[Home page (renamed)|Home-page-new-slug]]

이 경우 링크 텍스트로 "Home page (renamed)" 가 표시되고, 슬러그가 Home-page-new-slug 인 페이지로 연결됩니다.

대체 위키 페이지 구문#

[wiki_page:PAGE_SLUG] 구문을 사용할 수도 있습니다.

[wiki_page:Home]

프로젝트 간 참조에는 전체 프로젝트 경로를 지정합니다.

[wiki_page:namespace/project:Home]
[wiki_page:group1/subgroup:Home]

자동 URL 인식#

Markdown 서식 없이 위키 페이지의 전체 URL을 붙여 넣으면 GitLab 이 자동으로 링크로 변환하고, 페이지 슬러그의 하이픈을 공백으로 바꿔 표시합니다.

https://gitlab.com/namespace/project/-/wikis/Home-page-new-slug

이 URL은 "Home page new slug" 라는 텍스트를 가진 링크로 자동 렌더링됩니다(하이픈이 공백으로 변환됨).

직접 페이지 링크#

직접 페이지 링크는 위키의 최상위 수준에 있는 페이지를 가리키며 해당 페이지의 슬러그를 포함합니다.

다음 예시는 위키 루트에 있는 documentation 페이지로 연결됩니다.

[Link to Documentation](documentation-top-page)

직접 파일 링크#

직접 파일 링크는 현재 페이지를 기준으로 파일 확장자를 포함한 파일을 가리킵니다.

다음 예시가 <your_wiki>/documentation/related 페이지에 있다면 <your_wiki>/documentation/file.md로 연결됩니다.

[Link to File](file.md)

계층적 링크#

계층적 링크는 ./<page> 나 ../<page> 같은 상대 경로를 사용해 현재 위키 페이지를 기준으로 구성할 수 있습니다.

다음 예시가 <your_wiki>/documentation/main 페이지에 있다면 <your_wiki>/documentation/related로 연결됩니다.

[Link to Related Page](related)

다음 예시가 <your_wiki>/documentation/related/content 페이지에 있다면 <your_wiki>/documentation/main으로 연결됩니다.

[Link to Related Page](../main)

다음 예시가 <your_wiki>/documentation/main 페이지에 있다면 <your_wiki>/documentation/related.md로 연결됩니다.

[Link to Related Page](related.md)

다음 예시가 <your_wiki>/documentation/related/content 페이지에 있다면 <your_wiki>/documentation/main.md로 연결됩니다.

[Link to Related Page](../main.md)

루트 링크#

루트 링크는 /로 시작하며 위키 루트를 기준으로 합니다.

다음 예시는 <wiki_root>/documentation으로 연결됩니다.

[Link to Related Page](/documentation)

다음 예시는 <wiki_root>/documentation.md로 연결됩니다.

[Link to Related Page](/documentation.md)

diagrams.net 편집기#

위키에서는 diagrams.net 편집기를 사용해 다이어그램을 만들 수 있습니다. diagrams.net 편집기로 만든 다이어그램을 편집할 수도 있습니다. 다이어그램 편집기는 일반 텍스트 편집기와 서식 있는 텍스트 편집기 모두에서 사용할 수 있습니다.

자세한 내용은 Diagrams.net을 참고합니다.

일반 텍스트 편집기#

일반 텍스트 편집기에서 다이어그램을 만들려면 다음 단계를 따릅니다.

  1. 편집하려는 위키 페이지에서 Edit를 선택합니다.
  2. 텍스트 상자에서 일반 텍스트 편집기를 사용하고 있는지 확인합니다 (왼쪽 아래 버튼에 Switch to rich text editing 이 표시됩니다).
  3. 편집기 툴바에서 Insert or edit diagram ([diagram])을 선택합니다.
  4. app.diagrams.net 편집기에서 다이어그램을 만듭니다.
  5. Save & exit를 선택합니다.

다이어그램에 대한 Markdown 이미지 참조가 위키 콘텐츠에 삽입됩니다.

일반 텍스트 편집기에서 다이어그램을 편집하려면 다음 단계를 따릅니다.

  1. 편집하려는 위키 페이지에서 Edit를 선택합니다.
  2. 텍스트 상자에서 일반 텍스트 편집기를 사용하고 있는지 확인합니다 (왼쪽 아래 버튼에 Switch to rich text editing 이 표시됩니다).
  3. 다이어그램이 포함된 Markdown 이미지 참조에 커서를 놓습니다.
  4. Insert or edit diagram ([diagram])을 선택합니다.
  5. app.diagrams.net 편집기에서 다이어그램을 편집합니다.
  6. Save & exit를 선택합니다.

다이어그램에 대한 Markdown 이미지 참조가 위키 콘텐츠에 삽입되며, 이전 다이어그램을 대체합니다.

서식 있는 텍스트 편집기#

서식 있는 텍스트 편집기에서 다이어그램을 만들려면 다음 단계를 따릅니다.

  1. 편집하려는 위키 페이지에서 Edit를 선택합니다.
  2. 텍스트 상자에서 서식 있는 텍스트 편집기를 사용하고 있는지 확인합니다 (왼쪽 아래 버튼에 Switch to plain text editing 이 표시됩니다).
  3. 편집기 툴바에서 More options (+)를 선택합니다.
  4. 드롭다운 목록에서 Create or edit diagram을 선택합니다.
  5. app.diagrams.net 편집기에서 다이어그램을 만듭니다.
  6. Save & exit를 선택합니다.

diagrams.net 편집기에서 보이는 그대로의 다이어그램이 위키 콘텐츠에 삽입됩니다.

서식 있는 텍스트 편집기에서 다이어그램을 편집하려면 다음 단계를 따릅니다.

  1. 편집하려는 위키 페이지에서 Edit를 선택합니다.
  2. 텍스트 상자에서 서식 있는 텍스트 편집기를 사용하고 있는지 확인합니다 (왼쪽 아래 버튼에 Switch to plain text editing 이 표시됩니다).
  3. 편집하려는 다이어그램을 선택합니다.
  4. 플로팅 툴바에서 Edit diagram ([diagram])을 선택합니다.
  5. app.diagrams.net 편집기에서 다이어그램을 편집합니다.
  6. Save & exit를 선택합니다.

선택한 다이어그램이 업데이트된 버전으로 대체됩니다.

위키 전용 Markdown

GitLab v19.5
Tier: Free, Premium, Ultimate
Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated
원문 보기

요약

다음 주제에서는 위키 내부의 링크가 어떻게 동작하는지 설명합니다. 위키 페이지로 링크할 때는 페이지 이름 대신 페이지 슬러그를 사용합니다. 위키는 표준 Markdown 링크 외에도 위키 페이지 간 링크를 간단하게 만드는 특수 위키 스타일 링크 구문을 지원합니다.

링크#

다음 주제에서는 위키 내부의 링크가 어떻게 동작하는지 설명합니다.

위키 페이지로 링크할 때는 페이지 이름 대신 페이지 슬러그를 사용합니다. 페이지 슬러그는 페이지 제목을 URL에 적합한 형태로 바꾼 것으로, 공백은 하이픈으로 바뀌고 특수 문자는 제거되거나 변환됩니다. 예를 들어 제목이 "How to Use GitLab" 인 페이지의 슬러그는 How-to-Use-GitLab 입니다.

위키 스타일 링크#

위키는 표준 Markdown 링크 외에도 위키 페이지 간 링크를 간단하게 만드는 특수 위키 스타일 링크 구문을 지원합니다.

이중 대괄호 구문#

이중 대괄호를 사용해 위키 페이지로 링크할 수 있습니다.

[[Home]]

이 구문은 슬러그가 Home 인 위키 페이지로 연결되는 링크를 만듭니다. 페이지가 없으면 링크를 선택했을 때 해당 페이지를 만들 수 있습니다.

페이지 슬러그에 하이픈이 포함된 경우, 링크는 슬러그를 그대로 표시합니다.

[[Home-page-new-slug]]

이 경우 링크 텍스트로 Home-page-new-slug가 표시됩니다.

사용자 지정 텍스트가 있는 이중 대괄호 구문#

표시하려는 제목이 페이지 슬러그와 다르면 파이프(|) 문자를 사용해 표시 텍스트와 페이지 슬러그를 구분합니다.

[[How to use GitLab|how-to-use-gitlab]]

이 경우 링크 텍스트로 "How to use GitLab" 이 표시되고, 슬러그가 how-to-use-gitlab 인 페이지로 연결됩니다.

하이픈이 포함된 슬러그를 가진 페이지에 더 읽기 쉬운 제목을 붙일 때도 이 구문을 사용할 수 있습니다.

[[Home page (renamed)|Home-page-new-slug]]

이 경우 링크 텍스트로 "Home page (renamed)" 가 표시되고, 슬러그가 Home-page-new-slug 인 페이지로 연결됩니다.

대체 위키 페이지 구문#

[wiki_page:PAGE_SLUG] 구문을 사용할 수도 있습니다.

[wiki_page:Home]

프로젝트 간 참조에는 전체 프로젝트 경로를 지정합니다.

[wiki_page:namespace/project:Home]
[wiki_page:group1/subgroup:Home]

자동 URL 인식#

Markdown 서식 없이 위키 페이지의 전체 URL을 붙여 넣으면 GitLab 이 자동으로 링크로 변환하고, 페이지 슬러그의 하이픈을 공백으로 바꿔 표시합니다.

https://gitlab.com/namespace/project/-/wikis/Home-page-new-slug

이 URL은 "Home page new slug" 라는 텍스트를 가진 링크로 자동 렌더링됩니다(하이픈이 공백으로 변환됨).

직접 페이지 링크#

직접 페이지 링크는 위키의 최상위 수준에 있는 페이지를 가리키며 해당 페이지의 슬러그를 포함합니다.

다음 예시는 위키 루트에 있는 documentation 페이지로 연결됩니다.

[Link to Documentation](documentation-top-page)

직접 파일 링크#

직접 파일 링크는 현재 페이지를 기준으로 파일 확장자를 포함한 파일을 가리킵니다.

다음 예시가 <your_wiki>/documentation/related 페이지에 있다면 <your_wiki>/documentation/file.md로 연결됩니다.

[Link to File](file.md)

계층적 링크#

계층적 링크는 ./<page> 나 ../<page> 같은 상대 경로를 사용해 현재 위키 페이지를 기준으로 구성할 수 있습니다.

다음 예시가 <your_wiki>/documentation/main 페이지에 있다면 <your_wiki>/documentation/related로 연결됩니다.

[Link to Related Page](related)

다음 예시가 <your_wiki>/documentation/related/content 페이지에 있다면 <your_wiki>/documentation/main으로 연결됩니다.

[Link to Related Page](../main)

다음 예시가 <your_wiki>/documentation/main 페이지에 있다면 <your_wiki>/documentation/related.md로 연결됩니다.

[Link to Related Page](related.md)

다음 예시가 <your_wiki>/documentation/related/content 페이지에 있다면 <your_wiki>/documentation/main.md로 연결됩니다.

[Link to Related Page](../main.md)

루트 링크#

루트 링크는 /로 시작하며 위키 루트를 기준으로 합니다.

다음 예시는 <wiki_root>/documentation으로 연결됩니다.

[Link to Related Page](/documentation)

다음 예시는 <wiki_root>/documentation.md로 연결됩니다.

[Link to Related Page](/documentation.md)

diagrams.net 편집기#

위키에서는 diagrams.net 편집기를 사용해 다이어그램을 만들 수 있습니다. diagrams.net 편집기로 만든 다이어그램을 편집할 수도 있습니다. 다이어그램 편집기는 일반 텍스트 편집기와 서식 있는 텍스트 편집기 모두에서 사용할 수 있습니다.

자세한 내용은 Diagrams.net을 참고합니다.

일반 텍스트 편집기#

일반 텍스트 편집기에서 다이어그램을 만들려면 다음 단계를 따릅니다.

  1. 편집하려는 위키 페이지에서 Edit를 선택합니다.
  2. 텍스트 상자에서 일반 텍스트 편집기를 사용하고 있는지 확인합니다 (왼쪽 아래 버튼에 Switch to rich text editing 이 표시됩니다).
  3. 편집기 툴바에서 Insert or edit diagram ([diagram])을 선택합니다.
  4. app.diagrams.net 편집기에서 다이어그램을 만듭니다.
  5. Save & exit를 선택합니다.

다이어그램에 대한 Markdown 이미지 참조가 위키 콘텐츠에 삽입됩니다.

일반 텍스트 편집기에서 다이어그램을 편집하려면 다음 단계를 따릅니다.

  1. 편집하려는 위키 페이지에서 Edit를 선택합니다.
  2. 텍스트 상자에서 일반 텍스트 편집기를 사용하고 있는지 확인합니다 (왼쪽 아래 버튼에 Switch to rich text editing 이 표시됩니다).
  3. 다이어그램이 포함된 Markdown 이미지 참조에 커서를 놓습니다.
  4. Insert or edit diagram ([diagram])을 선택합니다.
  5. app.diagrams.net 편집기에서 다이어그램을 편집합니다.
  6. Save & exit를 선택합니다.

다이어그램에 대한 Markdown 이미지 참조가 위키 콘텐츠에 삽입되며, 이전 다이어그램을 대체합니다.

서식 있는 텍스트 편집기#

서식 있는 텍스트 편집기에서 다이어그램을 만들려면 다음 단계를 따릅니다.

  1. 편집하려는 위키 페이지에서 Edit를 선택합니다.
  2. 텍스트 상자에서 서식 있는 텍스트 편집기를 사용하고 있는지 확인합니다 (왼쪽 아래 버튼에 Switch to plain text editing 이 표시됩니다).
  3. 편집기 툴바에서 More options (+)를 선택합니다.
  4. 드롭다운 목록에서 Create or edit diagram을 선택합니다.
  5. app.diagrams.net 편집기에서 다이어그램을 만듭니다.
  6. Save & exit를 선택합니다.

diagrams.net 편집기에서 보이는 그대로의 다이어그램이 위키 콘텐츠에 삽입됩니다.

서식 있는 텍스트 편집기에서 다이어그램을 편집하려면 다음 단계를 따릅니다.

  1. 편집하려는 위키 페이지에서 Edit를 선택합니다.
  2. 텍스트 상자에서 서식 있는 텍스트 편집기를 사용하고 있는지 확인합니다 (왼쪽 아래 버튼에 Switch to plain text editing 이 표시됩니다).
  3. 편집하려는 다이어그램을 선택합니다.
  4. 플로팅 툴바에서 Edit diagram ([diagram])을 선택합니다.
  5. app.diagrams.net 편집기에서 다이어그램을 편집합니다.
  6. Save & exit를 선택합니다.

선택한 다이어그램이 업데이트된 버전으로 대체됩니다.