Home - nolboo/wiki-syntax GitHub Wiki

[TOC]

Wiki Syntax test of GitHub vs Gitlab vs Bitbucket

각 서비스의 wiki-syntax 저장소의 위키에 동시에 올려서 마크다운 문법의 동작 유무를 테스트하기 위해 만든 문서이며, 마크다운 문법을 중심으로 비교한다.

비트버킷은 파일 이름이 case-sensitive하다. 대문자가 하나 들어간 파일명을 소문자로 고쳐서 푸시했는데 새로 업데이트할 수 없다. 서버에서 소문자 파일을 새로운 내용으로 만들어도 파일명을 바꿀 수 없었다. 저장소를 통째로 지우고 새로 시작해야 한다.

저장소가 비공개라고 하더라도 공개 위키를 만들 수 있으며, 일반 편집이 가능하도록 할 수 있다.

  • 디렉토리와 같은 파일 이름이 있는 경우는 피하자.

미디어위키 링크

  • 깃허브에선 [.md](/nolboo/wiki-syntax/wiki/.md) 확장자는 깨진 이미지 링크로 처리되고, [wiki.png](/nolboo/wiki-syntax/wiki/wiki.png)로 wiki.png 이미지를 보여줄 수 있다. 수직 정렬이 어긋난다. Adding links to wikis
  • 비트버킷은 [.md](/nolboo/wiki-syntax/wiki/.md)가 그냥 일반문자로 처리된다. 당연히 [wiki.png](/nolboo/wiki-syntax/wiki/wiki.png)도 먹지않아 이미지도 보여줄 수 없다.
  • 깃랩은 [.md](/nolboo/wiki-syntax/wiki/.md)는 아예 제거되어 생략된다. [](/nolboo/wiki-syntax/wiki/) 인라인 코드에서 이중대괄호를 쓰면 확장자를 없애버리고, 인라인코드도 먹지않고 그 뒤의 문자를 다 나타내지 못하는 버그가 있다. 없어진 문자 중간에 이중대괄호로 둘러싼 그림은 보여준다. 이게 뭐야?

Home#블럭인용 과 같이 앵커 기능은 비트버킷 x

img 서브 디렉토리

  • 깃헙은 이미지만 서브디렉토리 미디어위키 링크를 지원하는 건가? Adding images to wikis

[](/nolboo/wiki-syntax/wiki/) 형식의 내부 링크를 전부 지원하므로, 일단 유력!

위의 것들은 깃헙에서 아예 깨진 링크로 나오고 빨간색으로 표시된다. 단, 오른쪽 Pages 목록에 같은 이름의 두 개의 파일명이 나타나지만 첫번째 것만 볼 수 있다. 같은 파일이 있는 경우 sub-dir2-sub-directory와 같은 파일명의 편집 화면으로 다이렉트되어 다른 이름의 파일을 생성하도록 유도한다.

깃랩에서는 위의 모든 것을 잘 지원하니 미디어위키 링크에서 서브디렉토리를 지원한다. Pages 탭에서도 두 개의 파일명이 나오며 각각의 파일을 불어와 보여준다.

마크다운 상대주소 링크

비트버킷에서는 [ ](/nolboo/wiki-syntax/wiki/) 형식의 미디어위키 차명링크를 사용할 수 없으며, 차명의 경우 마크다운 형식의 상대주소 링크만 사용해야 한다.

깃허브는 마크다운 상대주소의 서브 디렉토리를 파일 이름으로 간주하고 전체 파일에서 찾는다. .md를 붙인 경우 raw 파일로 인식하여 마크다운 소스를 그대로 보여준다. 깃헙의 경우 wiki/ 경로를 붙여도 같은 파일로 인식한다. 깃랩에서도 raw 파일로 인식하나 위키 저장소가 wikis이고, wiki/ 경로를 붙이는 것은 당연히 안되고, wikis/ 경로를 붙여도 안된다. 비트버킷도 마찬가지다.

깃랩은 마크다운 상대주소의 서브 디렉토리를 지원한다.

.md

깃헙은 깨진 링크를 빨간색으로 표시해준다.

내부링크

toc

thlorenz/doctoc: Generates table of contents for markdown files inside local git repository. Links are compatible with anchors generated by github or other sites.

블럭인용

이것은 블럭인용이며 일반적인 경우에는 라인의 처음에 >를 전부 달아야 한다.

>>>
이것은 블럭인용이며 일반적인 경우에는 라인의 처음에 `>`를 전부 달아야 한다.
>>>

이것은 블럭인용이며 일반적인 경우에는 라인의 처음에 >를 전부 달아야 한다.

>
이것은 블럭인용이며 일반적인 경우에는 라인의 처음에 `>`를 전부 달아야 한다.
>

Nested 인용은 표준과 동일하다.

첫번째 인용줄

두번째 인용줄

세번째 인용줄

>첫번째 인용줄
>>두번째 인용줄
>>>세번째 인용줄