Using RMarkdown

How I started using RMarkdown

Períodos de pandemia são sempre interessantes! Falo como se tivesse passado por diversos momentos como este; felizmente, isso não é verdade! Entretanto, foi nesse período que descobri o Rmarkdown.

O isolamento social trouxe possibilidades, como eu aprender o R. Pesquisando sobre Latex, tive acesso a diferentes linguagens para elaboração de relatórios reprodutíveis e dinâmicos. A necessidade faz a “força”. Resolvi explorar as possibilidades antes de me dedicar a aprender efetivamente alguma linguagem e descobri que o Rmarkdown é bem mais intuitivo e dinâmico do que o Latex, apesar de ainda precisar do Latex para implementação de equações, por exemplo.

Funcionalidades

Com RMarkdown, é possível:

• Compilar um documento em um relatório em diferentes formatos de saída, como PDF, HTML e Word.
• Produzir slides para apresentações.
• Criar dashboards interativas, com layouts atraentes e que se adaptam à tela do usuário.
• Criar relatórios interativos com Shiny.
• Escrever artigos científicos ou livros.
• Criar blogs ou sites.

Instalação e uso

Para começar a explorar esse mundo de textos dinâmicos, você precisa inicialmente:

install.packages("knitr")
install.packages("rmarkdown")

Depois, crie um novo arquivo de RMarkdown usando o comando File > New > File menu e selecione R > RMarkdown na lista. No contexto de um projeto, clique com o botão direito do mouse no projeto no Gerenciador de Soluções e selecione Adicionar R Markdown (ou Adicionar > Novo Item e selecionando R Markdown na lista).

Estrutura dos documentos

Todo documento RMarkdown é composto por três importantes tipos de conteúdo:
- Um cabeçalho YAML delimitado antes e depois por —
- chunks de códigos R ou outra linguagem compatível delimitado por ` `.
- Texto estruturado com formatação simples em\#\ para títulos e outros caracteres de formatação

Packages que usam RMarkdown

Se ficarem interessados em packages para construção de documentos em Rmarkdown, tenho usado:

library(vitae)
library(pagedown)
library(flexdashboard)
library(rticles)
library(bookdown)
library(distill)
library(hugodown)
library(xaringan)
library(xaringanExtra)
library(xaringanthemer)

Links interessantes

Alguns links para quem quiser se aventurar na composição de artigos científicos, textos acadêmicos e não-acadêmicos, apresentações, dashboards, sites e outras possibilidades que o Rmarkdown nos proporciona.

• RMarkdown: o mínimo que você precisa saber
• Pesquisa Reproduzível com R by Fernando Mayer e Walmes Zeviani
• Rmarkdown-rautu
• Iniciação do RMarkdown by Jayme Gomes dos Santos Junior
• Introdução a R para Visualização e Apresentação de Dados by Sillas Gonzaga
• R Markdown: The Definitive Guide by Yihui Xie, J. J. Allaire, Garrett Grolemund O site Pimp my rmd traz uma série de dicas interessantes para construção de arquivos com linguagem RMarkdown.
• R Markdown - The Definitive Guide by Yihui Xie, J. J. Allaire, Garrett Grolemund
• Introduction to R Markdown by Michael Clark