이 페이지는 Bitbucket에서 지원하는 Markdown 문법과 예제 페이지를 제공한다.
들어가기 앞서
- markdown 데스크톱 에디터 추천 Typora (다운로드 링크)
- Typora에서 markdown 문법을 이용해서 문서를 작성한 후 bitbucket에 커밋하면 100%까지는 안되지만
많은 부분 그대로 반영돼서 편리하게 이용할 수 있다.
- shields.io 를 이용해서 markdown 문서에 배지를 통해 간단하게 꾸밀 수 있다.
- shields.io에서 배지 생성시 logo를 추가할 수 있는 logo 리스트는 다음에서 확인할 수 있다. (로고 리스트 홈페이지)
- README.md 에 들어가면 좋을 내용을 정리한 문서로 다음 사이트에서 확인해볼 수 있다.
1. 템플릿 1
2. 템플릿 2
3. README.md 예시
헤더 설정
- 샾(#)의 개수를 이용해서 헤더별 크기를 조정할 수 있다.
# h1 헤더 입니다.
## h2 헤더 입니다.
### h3 헤더 입니다.
#### h4 헤더 입니다.
##### h5 헤더 입니다.
###### h6 헤더 입니다.
####### h7 헤더 입니다. (적용 안됨) |
| Markdown |
|---|
# h1 헤더 입니다.
## h2 헤더 입니다.
### h3 헤더 입니다.
#### h4 헤더 입니다.
##### h5 헤더 입니다.
###### h6 헤더 입니다.
####### h7 헤더 입니다. (적용 안됨) |
|
- 등호(=)와 대시(-)를 이용해서 문서의 제목과 부제목을 표현할 수 있다.
제목 입니다.
==========
부제목 입니다.
------------ |
| Markdown |
|---|
제목 입니다.
==========
부제목 입니다.
------------ |
|
블럭인용문자
- 꺽쇠(>) 를 이용해서 블럭인용문자를 사용할 수 있다.
> 블럭인용문자
> > 블럭인용문자 내부1
> > > 블럭인용문자 내부2 |
| Markdown |
|---|
> 블럭인용문자
> > 블럭인용문자 내부1
> > > 블럭인용문자 내부2 |
|
- 블럭인용문자 내부에서는 마크다운 문법을 포함시킬 수 있다.
> 블럭인용문자
> > # h1 입니다. > > > ~~취소선~~ |
| Markdown |
|---|
> 블럭인용문자
> > # h1 입니다.
> > > ~~취소선~~
|
|
목록
순서있는 목록
- 순서가 포함된 목록 (번호) - 순서가 포함된 목록은 숫자와 점을 이용해서 작성한다.
1. 사과
2. 바나나
3. 오렌지 |
| Markdown |
|---|
1. 사과
2. 바나나
3. 오렌지 |
|
- 어떤 순서로 입력하더라도 내림차순으로 정리된다.
1. 사과
3. 바나나
2. 오렌지 |
| Markdown |
|---|
1. 사과
3. 바나나
2. 오렌지 |
|
순서없는 목록
- 순서가 없는 목록은 *, +, - 를 이용해서 만들 수 있다.
| HTML |
|---|
<pre>
* 빨강
* 녹색
* 파랑
+ 빨강
+ 녹색
+ 파랑
- 빨강
- 녹색
- 파랑
* 빨강
- 녹색
+ 파랑
</pre> |
|
| Markdown |
|---|
* 빨강
* 녹색
* 파랑
+ 빨강
+ 녹색
+ 파랑
- 빨강
- 녹색
- 파랑
* 빨강
- 녹색
+ 파랑 |
|
맨 마지막을 보면 알 수 있듯이 +, -, * 를 혼합해서 사용할 수 있다.
코드 작성
- 들여쓰기 - 4개의 공백 혹은 한 번의 탭(TAB)을 만나면 코드 블럭이 생성되고 들여쓰기 않은 행을 만날 때 까지 계속해서 코드블럭이 적용된다.
| HTML |
|---|
<pre>
들여쓰기 시작 입니다.
This is example
들여쓰기 끝 입니다.
</pre> |
|
| Markdown |
|---|
들여쓰기 시작 입니다.
This is example
들여쓰기 끝 입니다. |
|
|---|
| Markdown |
|---|
> 한줄을 띄지 않고 사용할 경우 인식이 제대로 되지 않는 문제점이 있다. |
| HTML |
|---|
<pre>
들여쓰기 시작 입니다.
This is example
들여쓰기 끝 입니다.
</pre> |
|
| Markdown |
|---|
들여쓰기 시작 입니다.
This is example
들여쓰기 끝 입니다. |
|
|---|
- 코드 블럭 - <pre><code> 태그를 이용하는 방법
<pre><code>public class BootSpringBootApplication {
public static void main(String[] args) {
System.out.println("Hello, Curvc");
}
}</code></pre> |
| Markdown |
|---|
<pre><code>public class BootSpringBootApplication {
public static void main(String[] args) {
System.out.println("Hello, Curvc");
}
}</code></pre> |
|
|---|
- 코드 블럭 - ` ` ` 을 이용하는 방법 (1)
```
public class BootSpringBootApplication {
public static void main(String[] args) {
System.out.println("Hello, Curvc");
}
}
``` |
| Markdown |
|---|
```
public class BootSpringBootApplication {
public static void main(String[] args) {
System.out.println("Hello, Curvc");
}
}
``` |
|
|---|
- 코드 블럭 - ` ` ` 을 이용하는 방법 (문법 강조) (2)
```java
public class BootSpringBootApplication {
public static void main(String[] args) {
System.out.println("Hello, Curvc");
}
}
``` |
| Markdown |
|---|
```java
public class BootSpringBootApplication {
public static void main(String[] args) {
System.out.println("Hello, Curvc");
}
}
``` |
|
|---|
컨플루언스 마크다운에서는 적용이 안되고 있지만 실제로 다른 md 파일에서는 적용된다.
| ```System.out.println("Hello World !")``` |
| Markdown |
|---|
```System.out.println("Hello World !")``` |
|
|---|
수평선
<hr> * * * *** ***** - - - --------------------------------------- |
| Markdown |
|---|
<hr>
* * *
***
*****
- - -
--------------------------------------- |
|
|---|
링크 설정
- 1번의 경우 " " 안에 텍스트를 넣으면 Tooltip을 생성할 수 있다.
강조 문법
*single asterisks*
_single underscores_
**double asterisks**
__double underscores__
~~cancelline~~ |
| Markdown |
|---|
*single asterisks*<br>
_single underscores_<br>
**double asterisks**<br>
__double underscores__<br>
~~cancelline~~<br> |
|
|---|
이미지
-  형식을 적어주면 된다.
| Markdown |
|---|
 |
줄바꿈
- <br>태그와 공백을 이용해서 줄바꿈을 한다.
//띄어쓰기 없이 엔터쳤을 경우
1. 마크다운에서 줄 바꿈을 하기 위해서는 3칸이상 띄어쓰기를 해야 한다.
마치 이렇게 // 맨 끝에 3칸 공백 삽입
2. 마크다운에서 줄 바꿈을 하기 위해서는 3칸이상 띄어쓰기를 해야 한다.
마치 이렇게 // br태그 이용
3. 마크다운에서 줄 바꿈을 하기 위해서는 3칸이상 띄어쓰기를 해야 한다.<br>마치 이렇게 |
| Markdown |
|---|
1. 마크다운에서 줄 바꿈을 하기 위해서는 3칸이상 띄어쓰기를 해야 한다.
마치 이렇게
2. 마크다운에서 줄 바꿈을 하기 위해서는 3칸이상 띄어쓰기를 해야 한다.
마치 이렇게
3. 마크다운에서 줄 바꿈을 하기 위해서는 3칸이상 띄어쓰기를 해야 한다.<br>마치 이렇게 |
|
|---|