마크다운 사용법 - Quick Start

taewan.kim은 대부분의 내용을 markdown으로 관리하고 있습니다. markdown은 직관적이고 간단한 문법으로 컨텐츠 관리에 매우 효과적입니다. markdown에서 주로 이용되는 테그는 15개정도 입니다. 혼동되는 주요 테그를 정리하겠습니다.


헤더 (top)

H1 ~ H6까지 테그를 #으로 표현

# 헤더 스타일 (h1)
## 헤더 스타일 (h2)
### 헤더 스타일 (h3)
#### 헤더 스타일 (h4)
##### 헤더 스타일 (h5)
###### 헤더 스타일 (h6)
  • 출력 결과

헤더 스타일 (h1)

헤더 스타일 (h2)

헤더 스타일 (h3)

헤더 스타일 (h4)

헤더 스타일 (h5)
헤더 스타일 (h6)
  • 효과: 다음과 같은 코드와 동일한 결과가 됨
<h1>헤더 스타일 (h1)</h1>
<h2>헤더 스타일 (h2)</h2>
<h3>헤더 스타일 (h3)</h3>
<h4>헤더 스타일 (h4)</h4>
<h5>헤더 스타일 (h5)</h5>
<h6>헤더 스타일 (h6)</h6>

수평선 (top)

  • <hr />와 동일한 결과를 출력
  • ’-‘, ‘*‘, ‘_‘을 세개 이상 나열하면 수평선을 만듦
  • 단락 나누기 용도로 많이 사용.
***
___
___
  • 출력 결과




텍스트 출력 (top)

별도의 테그 없이 입력된 내용은 <p> ~ <\p> 처리가 됨

markdown은 직관적이고 간단한 문법으로 컨텐츠 관리에 매우 효과적입니다.
  • 효과: 다음과 같은 코드와 동일한 결과가 됨
<p>markdown은 직관적이고 간단한 문법으로 컨텐츠 관리에 매우 효과적입니다.</p>

텍스트 강조 (top)

*single asterisks* - 기울임체
_single underscores_ - 기울임체
**double asterisks** - 굵은글씨체
__double underscores__ - 기울임체/굵은글씨체
***triple underscores*** - 기울임체/굵은글씨체
~~cancelline~~ - 취소줄
  • 결과 출력

single asterisks - 기울임체
single underscores - 기울임체
double asterisks - 굵은글씨체
double underscores - 기울임체/굵은글씨체
triple underscores - 기울임체/굵은글씨체
cancelline - 취소줄


인용 (top)

  • 분문 중 인용된 글을 표시할 때 사용하며, “>” 기호를 모든 줄 앞에 붙임.
  • ”>” 기호의 개수에 따라 들여쓰기 레벨 조정 가능
  • 인용 블록 안에서 다른 마크다운 테그를 포함할 수 있음
  • 인용 블록 안에서 중첩 인용 표기 가능

인용 예제 1: 기본 스타일

> 인용되는 글입니다.
> 인용되는 글의 두 번째 줄.
> 인용되는 글의 세 번째 줄.
  • 출력 결과

인용되는 글입니다.
인용되는 글의 두 번째 줄.
인용되는 글의 세 번째 줄.

  • 인용문의 레벨을 설정 할 수 있음

인용 예제 2: 중첩 인용 및 스타일 적용

> 인용되는 첫 번째 줄입니다.
>> 인용되는 내용 안에서 다시 인용되는 부분입니다.
> (인용 수준을 변경할 때 이렇게 빈 줄 하나 넣어주세요)
> 꺽쇠 한 번만 쓰면 다시 상위 수준으로 표시됩니다.
> ###### 인용문 내부 헤더

인용되는 첫 번째 줄입니다.

인용되는 내용 안에서 다시 인용되는 부분입니다.

(인용 수준을 변경할 때 이렇게 빈 줄 하나 넣어주세요)

꺽쇠 한 번만 쓰면 다시 상위 수준으로 표시됩니다.

인용문 내부 헤더

인용 예제 2: tab 을 적용한 인용

  • 인용 기호 앞에 tab을 입력하면 인용문의 들여 쓰기를 작성 가능.
	> 인용되는 글입니다.
	> 인용되는 글의 두 번째 줄.
	> 인용되는 글의 세 번째 줄.
  • 출력 결과

    인용되는 글입니다.
    인용되는 글의 두 번째 줄.
    인용되는 글의 세 번째 줄.
    인용문의 레벨을 설정 할 수 있음


목록 (top)

  • MarkDown으로 숫자 리스트, 블릿 리스트를 표현할 수 있음.
  • 순차가 없는 리스트를 표현할 때는 ‘*‘, ‘+’, ‘-” 기호 사용 가능.
  • 순차가 있는 리스트를 표현할 때 ‘숫자’ 사용용
* 리스트1
+ 리스트2
    * 서브 리스트1
    * 서브리스트 2
- 리스트3
    1. 순차 리스트1
    2. 순차 리스트2
  • 출력 결과

  • 리스트1

  • 리스트2

    • 서브 리스트1
    • 서브리스트 2
  • 리스트3

    1. 순차 리스트1
    2. 순차 리스트2

코드 (top)

코드 유형 1: 공백

4개의 공백 또는 하나의 탭으로 들여쓰기를 만나면 변환되기 시작하여 들여쓰지 않은 행을 만날때까지 변환이 계속됨.

공백 없이 바로 시작...

    스페이스 4개로 시작
    스페이스 4개로 시작

공백 없이 바로 시작...
  • 출력 결과

공백 없이 바로 시작…

스페이스 4개로 시작
스페이스 4개로 시작

공백 없이 바로 시작…

코드 유형 2: 코드 블록

  • 코드 첫라인 앞과 마지막 라인 다음에 “```” (fense) 설치

코드 유형 3: 인라인 코드

스칼라에서는 `val a:Int = 3`과 같은 형식으로 변수를 선언합니다.
  • 출력 결과

스칼라에서는 val a:Int = 3과 같은 형식으로 변수를 선언합니다.

테이블 (top)

| 이름   | 설명  | 나이 |
| ----- | ---- | --- |
| 김태완  | 아빠  | 40 |
| 임선영  | 엄마  | 30 |
| 김민수  | 아들  | 2  |
이름 설명 나이
김태완 아빠 40
임선영 엄마 30
김민수 아들 2

테이블 정렬

  • 테이블 정렬: 헤더와 row 구분 자에 적용
    • 오른쪽 정렬
    • —-:
    • 왼쪽 정렬
    • :—-
    • 가운데 정렬
    • :—-:
| 이름   | 설명  | 나이 |
| :----- | ----: | :---: |
| 김태완  | 아빠  | 40 |
| 임선영  | 엄마  | 30 |
| 김민수  | 아들  | 2  |
이름 설명 나이
김태완 아빠 40
임선영 엄마 30
김민수 아들 2

기본 링크

  • 기본 문법: [링크걸 문구](http://주소)
[taewan.kim](http://taewan.kim)
  • HTML 변환 결과
<a href="http://taewan.kim">taewan.kim</a>
  • 출력 결과

taewan.kim

타이틀을 포함하는 링크

  • 기본 문법: [링크걸 문구](http://주소 “타이틀 문구”)
  • “타이틀 문구”는 툴팁으로 표현 됨
[taewan.kim](http://taewan.kim "김태완 블러그")
  • HTML 변환 결과
<a href="https://taewan.kim" title="김태완 블러그">taewan.kim</a>
  • 출력 결과

taewan.kim

참조 링크

  • 주소를 id로 참조
  • [id] 형식으로 지정
    [구글][1]
    [1]: http://www.google.com
  • 출력 결과

구글

주소만으로 링크

  • 주소를 “<“와 “>“기호로 감싸서 사용
<http://taewan.kim>
  • HTML 변환 결과
<a href="https://taewan.kim">http://taewan.kim</a>
  • 출력 결과

http://taewan.kim

네임드 앵커

  • 네임드 앵커는 특정 앵커로 점프하는 용도로 적합.

### 테이블 구성
  * [1장](#chapter-1)
  * [2장](#chapter-2)
  * [3장](#chapter-3)

###### 1장 <a id="chapter-1"></a>
1장의 내용은.....

###### 2장 <a id="chapter-2"></a>
2장의 내용은.....

###### 3장 <a id="chapter-3"></a>
3장의 내용은.....
  • 출력 결과

테이블 구성

1장

1장의 내용은…..

2장

2장의 내용은…..

3장

3장의 내용은…..


이미지 (top)

기본 이미지

문법: ![사진이름](사진경로)

![Minion](http://octodex.github.com/images/minion.png)
  • HTML 변환 결과
<img src="http://octodex.github.com/images/minion.png" alt="Minion" />
  • 출력 결과

Minion

타이클을 포함하는 이미지

  • 툴팁으로 타이틀이 출력 됨
![Alt text](http://octodex.github.com/images/stormtroopocat.jpg "The Stormtroopocat")
  • HTML 변환 결과
<img src="http://octodex.github.com/images/stormtroopocat.jpg" alt="Alt text" title="The Stormtroopocat" />
  • 출력 결과

Alt text

주소 참조 이미지

링크와 같이 참조 주소를 갖는 이미지

    ![Alt text][10]
    [10]: http://octodex.github.com/images/dojocat.jpg  "The Dojocat"
  • 출력 결과

Alt text


주석 (top)

<!--
마크다운으로 주석 처리 가능
-->
  • 출력결과 (출력 결과가 노출되지 않습니다.)

  • HTML 변환 결과

<!--
마크다운으로 주석 처리 가능
-->

각주 (top)

본문의 어떤 부분을 설명하거나 보충하기 위해 본문 아래쪽에 별도로 작성하는 간단한 설명문으로서 주로 내용의 출처를 밝힐 때 사용됩니다.

최근 스칼라는 매우 인기가 높은 언어이다.[^scala]

\[^scala]: 스칼라는 마틴 오더시크가 개발한 함수형 언어이다.
  • 주의사항: 각주 두번째 라인의 역슬레쉬는 hugo의 코드 블록의 제약 사항으로 부득이하게 입력한 것입니다.

  • 출력 결과

최근 스칼라는 매우 인기가 높은 언어이다.1


  1. 스칼라는 마틴 오더시크가 개발한 함수형 언어이다. [return]
작성자: 김태완
김태완 avatar
작성자: 김태완
1999년 부터 Java, Framework, Middleware, SOA, DB Replication, Cache, CEP, NoSQL, Big Data, Cloud를 키워드로 살아왔습니다. 현재는 빅데이터와 Machine Learning을 중점에 두고 있습니다.
E-mail: taewanme@gmail.com