Cabeçalho YAML

A primeira seção é cabeçalho YAML (opcional) usada na função render. Argumentos de personalização das saída podem ser especificadas no cabeçalho ou diretamente na função render.

Essa seção começa com --- e termina com ---.

---
title: "Título"
author: "Nome"
date: "Data"
---

Texto formatado com R Markdown

O texto na saída pode ser formatado usando um conjunto simples de sintaxe. Algumas das opções básicas estão listados abaixo:

Códigos R (usando chunks)

Para inserir códigos de R, como scripts e resultados, é possível usar a sintaxe chunk que começa com ` ` ` { r } e termina com ` ` `. Uma ou mais linhas podem ser incluídas no mesmo bloco.

Exemplo:

```{r}
data(CO2)
head(CO2)
summary(CO2[,4:5])
```

data(CO2)
head(CO2)

##   Plant   Type  Treatment conc uptake
## 1   Qn1 Quebec nonchilled   95   16.0
## 2   Qn1 Quebec nonchilled  175   30.4
## 3   Qn1 Quebec nonchilled  250   34.8
## 4   Qn1 Quebec nonchilled  350   37.2
## 5   Qn1 Quebec nonchilled  500   35.3
## 6   Qn1 Quebec nonchilled  675   39.2

summary(CO2[,4:5])

##       conc          uptake     
##  Min.   :  95   Min.   : 7.70  
##  1st Qu.: 175   1st Qu.:17.90  
##  Median : 350   Median :28.30  
##  Mean   : 435   Mean   :27.21  
##  3rd Qu.: 675   3rd Qu.:37.12  
##  Max.   :1000   Max.   :45.50

Chunk incluem algumas opções para a formatação do bloco de códigos e para exibir os resultados. Os argumentos são especificados dentro do primeiro par de chaves {r, highlight = FALSE }. Algumas dessas opções:

• eval - Avaliar validade do código (default eval = FALSE);
• echo - Mostrar código no documento de saída (default = TRUE);
  
• collapse - Recolher todos saída em bloco único (default = FALSE);
  
• results (default = ‘markup’):
  • ‘markup’ - mostrar os resultados destacados no meio do código;
  • ‘hide’ - não mostrar os resultados;
  • ‘hold’ - colocar todos os resultados abaixo de todo o código;
  • ‘asis’ - mostrar os resultados brutos no meio do código.
• message - Mostrar mensagens no código no documento de saída (default = TRUE);
  
• warning - Mostrar mensagens de warnings no documento de saída (default = TRUE);
  
• highlight - Descatar código fonte (default = TRUE);
  
• fig.height, fig.width - Dimensões das figuras em polegadas.

Exemplo:

```{r, highlight = FALSE}
# Show R version
getRversion()
```

# Show R version
getRversion()

## [1] '3.5.2'

Gráficos

Os resultados gráficos podem ser incluídos no documento com os resultado da saída, exatamente como as funções de plot do R. Por padrão, os tamanhos das figuras são especifidos no cabeçalho YAML ou na função render, mas também os tamanhos podem ser especificados para cada gráfico usando as opções do chunk.

Exemplo:

```{r, fig.width = 4, fig.height = 4}
plot(1:10,1:10)
```

plot(1:10, 1:10)  

Tabelas

As tabelas podem ser incluídas usando a opção de impressão (print) nos códigos R (código chunks) ou usando as funções para formatar dados em tabelas disponíveis no R. Alguns exemplos são as funções kable do pacote knitr, xtable do pacote xtable e a função stargazer do pacote stargazer.

Exemplo:

```{r}
require(knitr)
CO2[1:10,]
knitr::kable(CO2[1:10,], caption = "Tabela com kable")
```

require(knitr)
CO2[1:10,]

##    Plant   Type  Treatment conc uptake
## 1    Qn1 Quebec nonchilled   95   16.0
## 2    Qn1 Quebec nonchilled  175   30.4
## 3    Qn1 Quebec nonchilled  250   34.8
## 4    Qn1 Quebec nonchilled  350   37.2
## 5    Qn1 Quebec nonchilled  500   35.3
## 6    Qn1 Quebec nonchilled  675   39.2
## 7    Qn1 Quebec nonchilled 1000   39.7
## 8    Qn2 Quebec nonchilled   95   13.6
## 9    Qn2 Quebec nonchilled  175   27.3
## 10   Qn2 Quebec nonchilled  250   37.1

knitr::kable(CO2[1:10,], caption = "Tabela com kable")