Ilustração por Alison Horst

Como comecei a usar 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.

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.

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).

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

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)

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.


Credits: Ilustração por Alisson Horst

Avatar
Renata Oliveira
Professor at the Department of Applied Social Sciences

My research interests include spatial analysis, city logistics and accessibility.

Next