R Markdown - Visão geral

Markdown é uma forma simples de criar relatórios, documentos, apresentações e muito mais. Com essa sintaxe de formatação simples, você pode criar documentos HTML, PDF e MS Word. Para obter mais detalhes sobre o uso do R Markdown, visite http://rmarkdown.rstudio.com.

Para iniciar é bem simples. Bastar instalar o R e o Rstudio. Já no Rstudio, vá em “file -> new file -> R markdown” e clique em OK. Pronto! você já pode começar a escrever seu documento misturado com códigos em R.
Quando quiser gerar seu documento para visualizar o resultado, basta clicar no botão Knit na parte superior da janela de edição do Rstudio. Um documento é gerado (por padrão um HTML - página web), incluindo tanto o conteúdo quanto a saída de qualquer fragmento de código R embutido no documento.

Veja abaixo algumas dicas de como inserir elementos e formatações no seu documento R-markdown.

Tabela de Conteúdo

Blocos de código

Para incorporar um um fragmento de código R como este:

summary(cars)  
##      speed           dist       
##  Min.   : 4.0   Min.   :  2.00  
##  1st Qu.:12.0   1st Qu.: 26.00  
##  Median :15.0   Median : 36.00  
##  Mean   :15.4   Mean   : 42.98  
##  3rd Qu.:19.0   3rd Qu.: 56.00  
##  Max.   :25.0   Max.   :120.00

Basta escrever dessa forma:

#```{r }  
#    summary(cars)  
#```

Sem a #, três acentos graves abrem a janela e código e três acentos graves fecham. As chaves com a letra “r” {r} apenas informa o Rstudio que o bloco de código que seguirá será em linguagem R, mas o Rstudio também aceita outras linguagens como Python ou Bash.

Gráficos do R

Você também pode incorporar gráficos gerados pelo R.
Por exemplo, com o código abaixo você teria o plot que segue:

#```{r pressure, echo=FALSE}  
# plot(pressure)
#```

Observe que o parâmetro echo = FALSE foi adicionado ao fragmento de código para evitar a impressão do código R que gerou o gráfico.

Outros elementos em R Markdown

Você pode adicionar quase toda formatação de um documento normal, como no MSWORD.
Termine uma linha com dois espaços ou dois “enter” para iniciar um novo parágrafo.

Veja a tabela de elementos disponíveis abaixo:

Elemento Código Saída
Itálico *itálico* ou _itálico_ itálico ou itálico
Negrito **negrito** ou __negrito__ **negrito** ou __negrito__
Texto Tachado ~~texto taxado~~ texto taxado
sobrescrito m^2^ m2
subescrito H~2~O H2O
link para outras páginas [link Rstudio](www.rstudio.com) link Rstudio

Cabeçalhos ou Tópicos

Você pode adicionar títulos com diferentes níves facilmente apenas digintando # seguido de espaço:

# Nível 1 
## Nível 2  
### Nível 3  
#### Nível 4  
##### Níve 5  
###### Nível 6

O resultado é esse:

Nível 1

Nível 2

Nível 3

Nível 4

Níve 5
Nível 6

Mais elementos para o texto:

Outras Formatações

Elemento Código Saída
traço -- –
travesão --- —
reticências ... …
equação $A = \pi*r^{2}$ \(A = \pi*r^{2}\)

Inserindo imagem:

É também possível inserir imagens que estão salvas no computador, como logotipos e outros …

Código:

![](RStudio-Ball.png){width=5%}

imagem:
text alt for the image

Bloco de citação

Para citações ou ‘quotes’ basta adicionar um sinal de maior >.

Código:

> Este é um bloco que citação útil para citações diretas e observações  

 > > Que podem ser identadas...  
 
  >  > > Em vários níveis

Resultado:

Este é um bloco que citação útil para citações diretas e observações

Que podem ser identadas…

Em vários níveis

Notas de rodapé e liks para o documento

Ainda é possível adicionar notas de rodapé e links para qualquer parte do documento, como título, imagens, tabelas, sessões e outros. Basta utilizar o seguinte código [^1] ou [^2] e assim por diante. Cada número se torna uma notada de rodapé. Quando clicar no link, você será direcionado para o rodapé da página.

[^1]: Essa é uma sentença com nota de rodapé.

Essa é uma sentença com nota de rodapé.1

link para partes do documento

#link a ser marcado
[Esse é o título](#ancora1)
#Esse é o link
[qualquer texto que faça refência à sua ancora](#ancora1)

Você também pode criar links para sessões, como por exemplo para o primeiro tópico, R markdown

Listas

Veja alguns exemplos de como criar listas ou tópicos:

Lista não ordenada

* item
* item 2
  + sub-item 1
  + sub-item 2
  • item
  • item 2
    • sub-item 1
    • sub-item 2

Lista ordenada

1. item 1
2. item 2
    1. sub-item 1
    2. sub-item 2
  1. item 1
  2. item 2
    1. sub-item 1
    2. sub-item 2

Lista de tarefas

- [x] Escrever o exercício
- [ ] Atualizar o site
- [ ] Salvar o vídeo
  • Escrever o exercício
  • Atualizar o site
  • Salvar o vídeo

Tabelas

Também dá pra escrever tabelas assim:

Código

Campo 1 | Campo 2  
------------- | -------------
célula 1 | célula 2
célula 3 | célula 4

Saída:

Campo 1 Campo 2
célula 1 célula 2
célula 3 célula 4

Notas de rodapé:

  1. Essa é a referência àquela nota de rodapé.↩︎