Pandoc Template

pandoc의 템플릿에 대한 정리.

Format의 기본 뼈대

-s/--standalone 으로 문서를 변환ᅟ할 때 기본 템플릿 보기.

pandoc -D FORMAT
# FORMAT은 html 등이다.

문단

기본적으로 새 줄이 있어도 이어서 보여준다. 새 줄기호 자체는 두 개 이상의 공백(문단 나누기) 혹은 백슬래시 후 새 줄 하나(새 줄 내리기)로 표현.

글자 속성

_italic_, *italic* 이탤릭
__bold__, **bold** 볼드
`코드` 인라인 코드
Escaping
```
This is \*\*not\*\* in bold.
```

헤더

settext style

Level 1 : =를 아래에 둔 텍스트
```
a level one header
==================
```
Level 2 : -를 아래에 둔 텍스트
```
a level two header
-------------------
```

Atx style

# 갯수를 1~6개로 조정하여 지정

# A level one header
### a level three header ###

Pandoc 마크다운은 헤더 시작시에 바로 직전에 새줄이 있어야 한다.(원래 markdown은 그렇지 않다)
헤더들은 인라인 텍스트 포매핑도 포함할 수 있다.

Identifiers

헤더에는 HTML등의 ID값이 지정된다. 기본으로도 지정됨.

명시적 지정. 아래는 모두 foo로 ID 지정.

# My header {#foo}
## My header ## {#foo}
My other header {#foo}
----------------------

숫안 안 붙이기

# My Header {-}
# My header {.unnumbered}

이 ID 들은 --toc|--table-of-contents 옵션 사용시 이용됨.

특정 헤더를 향한 링크

# My Header {#foo}

go to header [Header title](#foo).
or go to header [My Header]. <- 헤더 텍스트에 중복에 없을 경우

Block Quotation

인용하기는 이메일 형식을 따른다.
인용 기본
```
> 이것은
> 이용된 것이다.
```

게으른 인용. 문단 시작 부분만 >

> 이것은
인용된 것이여.
> 이것도
인용된 것이여.

이중 인용. 한 칸 띄어서 다시 >를 해 준다.
```
> 인용이고
>
> > 이중 인용이지
```

Code Block

인덴트된 코드 블럭

4칸 공백 혹은 Tab으로 시작하는 블럭은 자동으로 코드 블럭으로 인식된다.
시작시의 공백은 무시된다.
코드 블럭의 빈 줄도 네칸 인덴트로 시작해야만 한다.

감싸진 코드 블럭

~ 혹은 ` 세 글자 이상으로 감싸진 코드 블럭은 인덴트 없이도 코드 블럭으로 간주된다.
```
~~~
if (a > 3) {
    moveShiep(5 * gravity, DOWN);
}
~~~
```
코드 블럭안에서 ~나 `를 사용할 경우에는 코드 블럭 감싸개를 더 많은 글자로 만들어주면된다.
코드 종류 명시하기 ```haskell 형태로 시작하면 haskell 코드 블럭임을 나타낸다.

라인 블럭

|으로 시작하는 줄들은 합쳐서 코드 블럭으로 간주. 내부 공백 유지됨.

| The limerick...
| In space
|    But the good
|    So seldoc
| 200 Main st.
| Berkeley, CA 94718

페이지 나눔

\newpage, \pagebreak는 페이지를 나누는 작용을 한다. 하지만 PDF와 Latex에만 적용된다. 원칙적으로 페이지 나눔은 지원하지 않는다. https://github.com/jgm/pandoc/pull/805 에서 논의중.

주석

Here is a footnote reference,[^1] and another.[^longnote]
 
[^1]: Here is the footnote.
 
[^longnote]: Here's one with multiple blocks.
 
    Subsequent paragraphs are indented to show that they
belong to the previous footnote.
 
여기부터는 일반 내용. 각주 아님.

각주의 지시자는 공백과 특수문자가 없는 한 단어이면 된다.
[^1]는 짧은 각주이다.
[^longnote]는 긴 각주의 에제이다. 각주 내용부분이 한 단계 인덴트 되어 있어야한다.

인라인 주석도 가능하다. 이 때는 글 내용 바로 옆에 이런 저런내용.^[인라인 주석. 문단을 포함할 수 없음] 그 다음내용 형태로 기술한다. 인라인 주석도 각주이지만 다른 점은 실제 내용 바로 옆에 각주 내용을 기술한다는 점과 여러 문단으로 구성할 수 없다는 점이다.

링크

꺽쇠로 감싸면 자동으로 링크를 걸어준다.
```
<http://google.com>
<sam@green.eggs.ham>
```

일반적인 링크

This is an [inline link](/url), and here's [one with
a title](http://fsf.org "click here for a good time!").

이미지(figure)

캡션달린 이미지

![This is the caption](/url/of/image.png)

문단내 포함되는 이미지

![This image won't be a figure](/url/of/image.png)\

목차