사용자 도구

사이트 도구


pandoc:template

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)\
pandoc/template.txt · 마지막으로 수정됨: 2014/08/11 16:55 저자 kwon37xi