Home - nolboo/wiki-syntax GitHub Wiki
[TOC]
Wiki Syntax test of GitHub vs Gitlab vs Bitbucket
각 서비스의 wiki-syntax 저장소의 위키에 동시에 올려서 마크다운 문법의 동작 유무를 테스트하기 위해 만든 문서이며, 마크다운 문법을 중심으로 비교한다.
- github-flavored-markdown 한글
- gitlab-flavored-markdown English
- php-markdown-extra 한글
- github-help-wiki-category from GitHub Help Wiki Category
- 아래 링크가 아무데서 안먹는 이유는?
- MultiMarkdown
- MultiMarkdown Gallery
비트버킷은 파일 이름이 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/
경로를 붙여도 안된다. 비트버킷도 마찬가지다.
깃랩은 마크다운 상대주소의 서브 디렉토리를 지원한다.
- php markdown extra
- php-markdown-extra
- php markdown extra 마크다운 링크 테스트
- 서브 디렉토리 문서 깃헙x
- 서브 디렉토리2 문서 깃헙x
- 서브 디렉토리 문서 깃헙x, 비트x
- 서브 디렉토리2 문서 깃헙x, 비트x
- 서브 디렉토리 문서 깃헙x, 비트x
- 서브 디렉토리2 문서 깃헙x, 비트x
.md
- 서브 디렉토리 문서 깃헙, 깃랩에서 raw파일로 인식.
- 서브 디렉토리2 문서 깃헙, 깃랩에서 raw파일
- 서브 디렉토리 문서 깃헙에서 raw파일, 깃랩x, 비트x
- 서브 디렉토리2 문서 깃헙에서 raw파일, 깃랩x, 비트x
- 서브 디렉토리 문서 깃헙x, 깃랩x, 비트x
- 서브 디렉토리2 문서 깃헙x, 깃랩x, 비트x
깃헙은 깨진 링크를 빨간색으로 표시해준다.
내부링크
toc
블럭인용
이것은 블럭인용이며 일반적인 경우에는 라인의 처음에 >
를 전부 달아야 한다.
>>>
이것은 블럭인용이며 일반적인 경우에는 라인의 처음에 `>`를 전부 달아야 한다.
>>>
이것은 블럭인용이며 일반적인 경우에는 라인의 처음에 >
를 전부 달아야 한다.
>
이것은 블럭인용이며 일반적인 경우에는 라인의 처음에 `>`를 전부 달아야 한다.
>
Nested 인용은 표준과 동일하다.
첫번째 인용줄
두번째 인용줄
세번째 인용줄
>첫번째 인용줄
>>두번째 인용줄
>>>세번째 인용줄