4 팬독

마크다운 텍스트에 대해 설명한다. RStudio에는 팬독 바이너리가 들어있고, 문서 변환기로서의 기능은 대부분은 Rmarkdown패키지에 녹아있다.

팬독 마크다운 문법

R에서는 rmarkdown 패키지에 의해 제공되는 Rmarkdown을 사용한다. rmarkdown은 pandoc마크다운을 내부적으로 사용하고, 팬독에 대한 래퍼 역학을 한다.

YAML 헤더

---
title: "Untitled"
author: "sunny"
output: html_document
---

앞뒤 — 는 다른 텍스트와 구별되는 경계
그 안에 필요한 내용을 [키:값]쌍으로 기재
YAML header 는 문서의 메타 정보를 입력하는 곳

단락

[code]
단락은 특별한 표시 없이 그대로 입력

단락의 구분은 하나 이상의 빈 줄로

그냥 엔터만 한줄쳐서 작성한다면
이는 그냥 한 단락으로 간주

줄을 강제로 바꾸기 위해서는  
스페이스를 두 번 누르고 엔터를 하거나

줄을 강제로 바꾸기 위해서는 끝에\
벡슬래시를 입력하고 엔터키 누르기

[result]
단락은 특별한 표시 없이 그대로 입력

단락의 구분은 하나 이상의 빈 줄로

그냥 엔터만 한줄쳐서 작성한다면 이는 그냥 한 단락으로 간주

줄을 강제로 바꾸기 위해서는
스페이스를 두 번 누르고 엔터를 하거나

줄을 강제로 바꾸기 위해서는 끝에
벡슬래시를 입력하고 엔터키 누르기

제목

[code]
# Header1

## Header2

### Header3

(헤더 앞에는 적어도 빈 줄 하나가 필요)

나는 베스킨라빈스 아이스크림 중
#22번과 #5번을 좋아한다.

나는 베스킨라빈스 아이스크림 중

#22번과 #5번을 좋아한다.

[result]

Header1

Header2

Header3

헤더는 행의 시작에 올 수 있다.

나는 베스킨라빈스 아이스크림 중 #22번과 #5번을 좋아한다.

나는 베스킬라빈스 아이스크림중

22번과 #5번을 좋아한다.

제목의 아이디와 클래스

팬독은 제목 부분에 HTML의 class, id 속성들을 정할 수 있는 문법 제공

{}안에 #은 아이디, “,”로 시작하는 것은 클래스

## 팬독 사용법 {#UsingPandoc .unnumbered}

UsingPandoc은 아이디, unnumbered는 클래스

한글 제목을 사용하는 경우에는 영문으로 아이디를 지정해줘야 함!

한글 제목만 사용경우, 자동으로 생성되는 내부 링크가 제대로 작동하지 않을 가능성이 높음. 이를 어기면 HTML 문서에서 toc:true 라는 옵션을 사용하여 만든 목차에서 링크를 제대로 찾지 못하는 현상이 나타난다. 따라서 제목과 아이디 부여하는 습관 갖도록 하자.

블록 인용

> This is a block quote. This
> paragraph has two lines.
>
> 1. This is a list inside a block quote.
> 2. Second item.

This is a block quote. This paragraph has two lines.

1. This is a list inside a block quote.
2. Second item.

있는 그대로 (Verbatim)

띄어쓰기(space) 4번

[code]
    library(ggplot2)
    ggplot(diamonds, aes(carat,price))+geom_point()

(경계사용코드)
~~~
library(ggplot2)
ggplot(diamonds, aes(carat,price)+geom_point())
~~~

[result]

library(ggplot2)
ggplot(diamonds, aes(carat,price))+geom_point()

library(ggplot2)
ggplot(diamonds, aes(carat,price)+geom_point())

library(ggplot2)
ggplot(diamonds, aes(carat,price)+geom_point())

행 블록(Line blocks)

일부러 텍스트의 구조를 바꿔 표현할 때.

수직 바 또는 파이프 기호 | 와 공백(space)하나로 시작하는 행으로 구성된 블록 사용.

[code]

| The limerick packs laughs anatomical
| In space that is quite economical.
|    But the good ones I've seen
|    So seldom are clean
| And the clean ones so seldom are comical

| 200 Main St.
| Berkeley, CA 94718

[result]

The limerick packs laughs anatomical In space that is quite economical.    But the good ones I’ve seen    So seldom are clean And the clean ones so seldom are comical

200 Main St. Berkeley, CA 94718

목록

팬독에는 목록을 위한 문법이 풍부하다

구분점 목록(Bullet List)

[code] +,*,- 중 하나로 사용 가능
- 하나
- 둘
- 셋

+ 하나
+ 둘
+ 셋

* 하나
* 둘
* 셋

[result]

• 하나
• 둘

• 셋

• 하나
• 둘

• 셋

• 하나
• 둘

• 셋

[code]
*The bullets need not be flush with the left margin; they may be
indented one, two, or three spaces. The bullet must be followed by
whitespace.

[result]

• The bullets need not be flush with the left margin; they may be indented one, two, or three spaces. The bullet must be followed by whitespace.

4-스페이스 규칙

[code]
* 첫 번째 단락
    첫 번째 단락에 포함된 서브 단락으로 공백 4개를 사용

* 두 번째 단락인데, 이 단락이 코드 블록을 포함하고 있을 때는 8개의 공백으로 표시
        library(ggolot2)
        ggplot(diamonds, aes(carat, price))+geom_point()

[result]

• 첫 번째 단락

  첫 번째 단락에 포함된 서브 단락으로 공백 4개를 사용

• 두 번째 단락인데, 이 단락이 코드 블록을 포함하고 있을 때는 8개의 공백으로 표시

  library(ggolot2)
  ggplot(diamonds, aes(carat, price))+geom_point()

[code]
* fruits
    + apples
        - macintosh
        - red delicious
    + pears
    + peaches
* vegetables
    + broccoli
    + chard

[result]

• fruits
  • apples
    • macintosh
    • red delicious
  • pears
  • peaches
• vegetables
  • broccoli
  • chard

순서 있는 목록(Ordered List)

숫자를 쓰고, 마침표를 쓰고, 하나의 공백을 주고 나서 내용을 입력한다. 이때 숫자는 의미가 없고 그냥 순서가 자동으로 정해진다.

[code]
1.  one
2.  two
3.  three
5.  one
7.  two
1.  three

[result]

1. one
2. two
3. three
4. one
5. two
6. three

로마 숫자로 구분점 만드는 것도 가능

[code]
(I)  one
(I)  two
(I)  three

[result]

1. one
2. two
3. three

알파벳으로구분점 만드는 것도 가능

[code]
A)  one
A)  two
A)  three

[result]

1. one
2. two
3. three

시작하는 번호

팬독은 목록에서 구분점과 시작번호를 주목함.

같은 구분점을 가지는 항목들은 하나의 목록으로 취급

[code]
 9)  Ninth
10)  Tenth
11)  Eleventh
       i. subone
      ii. subtwo
     iii. subthree

[result]

9. Ninth
10. Tenth
11. Eleventh
    1. subone
    2. subtwo
    3. subthree

정의 목록(Definition List)

정의 목록은 용어의 정의 등을 입력할 때 쓰인다.

Term 1

:   Definition of term1

Term 2 with *inline markup*

:   about definition of term2

        library(ggplot2)
        ggplot(diamonds, aes(carat,price)+geom_point())
        
    Third paragraph of definition 2.)

Term 1

Definition of term1

Term 2 with inline markup

about definition of term2

library(ggplot2)
ggplot(diamonds, aes(carat,price)+geom_point())

Third paragraph of definition 2.)

수평선

+,-,_ 기호 3개 이상 ==> 수평선

***

---

___

---

---

---

표

팬독이 제공하는 표 문법은

• 심플
• 멀티라인
• 그리드
• 파이프

총 4가지. 처리하기 까다로움. 자세히는 설명하지 않는다.

CJK(중국, 일본, 한국)언어는 더블-바이트 언어라 문자의 폭에 문제가 생긴다. D2Coding과 같은 한글 고정폭 폰트 사용하면 조금은 해결가능. but, 부족한 경우 많음

백슬래시 이스케이프

\*\*있는 그대로\*\*

**있는 그대로**

**있는 그대로**

있는 그대로

인라인 포매팅

강조: _ 기호나 *

*약한 강조*, **강한 강조**

약한 강조, 강한 강조

텍스트 삭제 표시

이것은 ~~삭제된 단어~~입니다.

이것은 삭제된 단어입니다.

윗첨자, 아랫첨자

^기호와 ~기호를 사용하면 된다. 첨자로 들어간 부분에 띄어쓰기가 있다면 백슬레시(\)쓰고 한 칸을 띄어 주고 사용.

이것은 연습^위의 첨자^이고, 또 이것은 연습~아래의 첨자~이다.

이것은 연습^위의 첨자^이고, 또 이것은 연습~아래의 첨자~이다.

이것은 연습^위의\ 첨자^이고, 또 이것은 연습~아래의\ 첨자~이다.

이것은 연습^{위의 첨자}이고, 또 이것은 연습_{아래의 첨자}이다.

수식

rmarkdown은 HTML 문서를 랜더링할 때 MathJax 사용.

인라인 수식의 경우 $감싸고, 블록 수식인 경우 $$감싼다.   그 안에는 레이텍에서 사용하는 수식 쓰면 된다.

ex1.
비율은 $y = \frac{a}{a+b}$ 로 표시한다.

비율은 \(y = \frac{a}{a+b}\) 로 표시한다.

ex2.
$$\begin{array}{ccc}
x_{11} & x_{12} & x_{13}\\
x_{21} & x_{22} & x_{23}
\end{array}$$

\[\begin{array}{ccc} x_{11} & x_{12} & x_{13}\\ x_{21} & x_{22} & x_{23} \end{array}\]

Link

자동 링크

Url 이나 이메일 주소 등을 <> 안에 넣으면 링크로 랜더링 된다.

<http://naver.com>

<sunsmiling@naver.com>

http://naver.com

sunsmiling@naver.com

인라인 링크

인라인 링크는 [링크 설명 텍스트], (링크의 URL) 문법 사용. 인라인 링크에서 메일을 보내고자 할 때는 mailto: 를 입력하면 된다.

[sunny site](http://smiling-sun.tistory.com/)에 놀러오세요.

[이곳으로](mailto:sunsmiling@naver.com)으로 메일을 보내세요

sunny site에 놀러오세요.

이곳으로으로 메일을 보내세요

레퍼런스 링크

프로그래밍에서 변수처럼, 자주 사용하는 웹 주소등을 저장해놓고 쓰는 방법. 아무데서나 사용 가능(안보임).

[변수명], 콜론(:), space, URL

[구글]: http://www.google.co.kr

[팬독 사이트]: http://pandoc.org/index.html

[구글]에서 검색해보면 ...

구글에서 검색해보면 …

문서 내부 링크

앞서 헤더에 아이디 주는 방법:

[서론] (#AboutMarkdown)

문서에 내부 링크 주는 방법:

[링크인덱스](./html문서#ID)

A 문서의 저자의견을 보면

그림 삽입

pdf에서는 제대로 랜더링 되지만, html, docs에서는 제대로 랜더링 되지 않으므로 knir패키지의 include_graphics() 함수와 크기, 위치 조정하는 청크 옵션 사용할 것을 권자

![이미지](url/to/the/image.png)

이미지

.Rmd파일에서 참고 문헌과 인용 표시

• 다양한 포멧과 확장자 존재
• 팬독에서는 오픈소스참고문헌 관리 데이터베이스 포멧을 지원

• Rmd 파일에 참고문헌 DB를 추가할 때는 YAML 헤더의 bibiography라는 필드에 DB 파일명으로 항목을 지정

  /—

  title: 알마크다운에 대하여

  author: SBKo

  bibliography: example.bibtex

  output:

  html_document:

  toc: true

  /—

  알마크다운 패지[@allaire2014]에 따르면

• 스타일 지정하기 학술지마다의 정해진 스타일.(팬독의 default: ‘저자-연도’)

스타일을 바꾸기 위해서는 스타일 정의 시트 파일(.csl)을 다운받아, YAML 해더에서 csl 필드를 사용하면 된다.

주석 달기

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.

        { some.code }

    The whole paragraph can be indented, or just the first
    line.  In this way, multi-paragraph footnotes work like
    multi-paragraph list items.

This paragraph won't be part of the note, because it
isn't indented.

Here is a footnote reference,¹ and another.²

This paragraph won’t be part of the note, because it isn’t indented.

---

1. Here is the footnote.↩

2. Here’s one with multiple blocks.

   Subsequent paragraphs are indented to show that they belong to the previous footnote.

   { some.code }

   The whole paragraph can be indented, or just the first line. In this way, multi-paragraph footnotes work like multi-paragraph list items.↩