R Markdown = R + Markdown

O R Markdown é uma sintaxe responsável por integrar R e o Markdown. Meio óbvio certo?

Este integração - entre código em R e conversão de texto do Markdown - faz do R Markdown uma ferramenta poderosissíma. Em arquivo único de R Markdown, você pode:

• Salvar, Executar e Visualizar Códigos de R.

• Gerar relatórios dinâmicos de altíssima qualidades.

• Documentos Transparentes e Replicáveis.

Como funciona o R Markdown?

YAML Header

---
title: "example_markdown"
author: "Tiago Ventura"
date: "2/8/2021"
output: html_document
---

Code Chunk

Os "chunks" começam com um cabeçalho abaixo:

# Exemplo de Chunk

Tudo entre estes dois sinais são lidos como um script de R.

Executar o Chunk: Cmd / Ctrl + Enter.

Criar um novo Chunk Cmd / Ctrl + alt + i.

Ao executar um "chunk", o resulto aparecerá em uma tela a seguir do seu código. Este será o resultado final a ser incluso no seu documento de R Markdown

Texto Markdown

Lista de Ajuda: help > cheatsheets > R Markdown Reference Guides

Templates

Há diversos templates, sobretudo para arquivos html, em R Markdown. Seguem alguns exemplos:

• rmdformats

• Notebooks

• Artigos

Code Chunks Customizaçao.

Os "chunks" de código possuem diversas opções de customização. Essas opções são incluídas no nome do "chunk", separado por vírgulas.

#```{r eval=FALSE}

Mais úteis:

- `eval=FALSE`: seu código é adicionado ao documento final, porém não é avaliado pelo R. 
- `echo=FALSE`: seu código não é adicionado ao documento final, porém é avaliado pelo R. 

Compilando.

Após você finalizar seu documento (definir a YAML, escrever seus códigos, e escrever o texto), você precisa compilar todas essas informações em um documento unificado a ser convertido para html, pdf, ou doc.

Para compilar, você pode manualmente apertar no botão knit no topo do seu código.

knitr::include_graphics("figs/knit_button.png")

Desafio