====== Pandoc Template ======
[[:pandoc|pandoc]]의 템플릿에 대한 정리.

===== Format의 기본 뼈대 =====
''-s/%%--%%standalone'' 으로 문서를 변환ᅟ할 때 기본 템플릿 보기.
<code sh>
pandoc -D FORMAT
# FORMAT은 html 등이다.
</code>

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

===== 글자 속성 =====
  * ''_italic_'', ''*italic*'' 이탤릭
  * ''<nowiki>__bold__</nowiki>'', ''<nowiki>**bold**</nowiki>'' 볼드
  * ''`코드`'' 인라인 코드
  * Escaping<code>
This is \*\*not\*\* in bold.
</code>
===== 헤더 =====
==== settext style ====
  * Level 1 : ''=''를 아래에 둔 텍스트<code>
a level one header
==================
</code>
  * Level 2 : ''-''를 아래에 둔 텍스트<code>
a level two header
-------------------
</code>

==== Atx style ====
  * ''#'' 갯수를 1~6개로 조정하여 지정<code>
# A level one header
### a level three header ###
</code>
  * Pandoc 마크다운은 헤더 시작시에 바로 직전에 새줄이 있어야 한다.(원래 markdown은 그렇지 않다)
  * 헤더들은 인라인 텍스트 포매핑도 포함할 수 있다.

==== Identifiers ====
  * 헤더에는 HTML등의 ID값이 지정된다. 기본으로도 지정됨.
  * 명시적 지정. 아래는 모두 ''foo''로 ID 지정.<code>
# My header {#foo}
## My header ## {#foo}
My other header {#foo}
----------------------
</code>
  * 숫안 안 붙이기<code>
# My Header {-}
# My header {.unnumbered}
</code>
  * 이 ID 들은 ''%%--toc|--table-of-contents%%'' 옵션 사용시 이용됨.
  * 특정 헤더를 향한 링크<code>
# My Header {#foo}

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

===== Block Quotation =====
  * 인용하기는 이메일 형식을 따른다.
  * 인용 기본 <code>
> 이것은
> 이용된 것이다.
</code>
  * 게으른 인용. 문단 시작 부분만 ''>''<code>
> 이것은
인용된 것이여.
> 이것도
인용된 것이여.
</code>
  * 이중 인용. 한 칸 띄어서 다시 ''>''를 해 준다.<code>
> 인용이고
>
> > 이중 인용이지
</code>

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

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

==== 라인 블럭 ====
  * ''|''으로 시작하는 줄들은 합쳐서 코드 블럭으로 간주. 내부 공백 유지됨.<code>
| The limerick...
| In space
|    But the good
|    So seldoc
| 200 Main st.
| Berkeley, CA 94718
</code>

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

===== 주석 =====
<code markdown>
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.

여기부터는 일반 내용. 각주 아님.
</code>
  * 각주의 지시자는 공백과 특수문자가 없는 한 단어이면 된다.
  * ''[^1]''는 짧은 각주이다.
  * ''[^longnote]''는 긴 각주의 에제이다. 각주 내용부분이 한 단계 인덴트 되어 있어야한다.

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

===== 링크 =====
  * 꺽쇠로 감싸면 자동으로 링크를 걸어준다.<code markdown>
<http://google.com>
<sam@green.eggs.ham>
</code>
  * 일반적인 링크<code markdown>
This is an [inline link](/url), and here's [one with
a title](http://fsf.org "click here for a good time!").
</code>

===== 이미지(figure) =====
  * 캡션달린 이미지<code markdown>
![This is the caption](/url/of/image.png)
</code>
  * 문단내 포함되는 이미지<code markdown>
![This image won't be a figure](/url/of/image.png)\
</code>