1 Título

1.1 Subtítulo

1.1.1 E por aí vai…

2 Mudando os estilos das fontes

Se quero escrever algo em negrito, uso dois asteriscos antes e depois.

Se quero colocar algo em itálico, uso um asterisco antes e um depois.

Para colocar algo sobrescrito, use o acento circunflexo ^antes e ^depois. Se desejar subescrito, use til _antes e _depois. Se quiser riscar a palavra, use dois acentos til ~~antes e depois~~.

3 Citando listas

Posso também colocar listas no meu texto. Se não precisar de ordem, uso um asterisco seguido de espaço e o nome do item.

Item 1

Mas se desejo colocar subitem, dou um tab e uso o +.

Item 2
- Subitem 2

Mas se desejar listas numeradas,aí é só utilizar o número seguido de ponto. E para subitens, usar as letras i), ii), iii)…

Item 1
Item 2
1. Item 2.1
2. Item 2.2

4 Adicionando links

E se eu quiser adicionar links? Tem como?

Claro que tem! Para isso usamos a estrutura formada por dois colchetes [] seguida de dois parênteses (). O nome do link fica dentro dos colchetes e o link propriamente dito fica entre parênteses.

Site da Prof. Letícia Raposo

5 Adicionando imagens

Para adicionar uma imagem é simples. A lógica é parecida com a do link, mas no caso, adicionamos um ponto de exclamação antes dos dois colchetes. Dentro deles fica a legenda e entre parênteses o link da imagem. Ela pode ser on-line ou local. Se for local, coloque todo o caminho da pasta onde fica a imagem, acompanhada de /nome_da_imagem.png. Pode ser em .jpg também! :)

Prof. Letícia Raposo

Para controlar o tamanho da imagem, você pode usar {width=40%} após o comando, ajustando, respectivamente, a largura e a altura da imagem.

Prof. Letícia Raposo

Neste caso, a imagem foi aumentada em 40%.

6 Adicionando citações

E que tal citações em blocos? Temos também!

Basta acrescentarmos o sinal de maior seguido de um espaço. Você perceberá que está funcionando quando a cor mudar para verde.

Bem fácil, não é mesmo?

7 Adicionando chunks

Ok, ok! Falamos bastante da parte textual. E os códigos do R?

Bem, agora precisamos informar ao R que o que iremos escrever agora é um código e não um texto. Para isso, adicionamos os chunks. Você pode fazer isso manualmente colocando três crases seguidas de {r} e, ao final do código, fechar com as três crases.

a <- 3

Se preferir, você pode clicar no botão * Insert* (com um símbolo verde e um C branco) e, em seguida, R.

Assim, toda vez que estiver dentro de um chunk, você deve imaginar que está dentro de um R script e executar as tarefas da mesma forma como fazia antes.

8 Adicionando códigos em linha

Muitas vezes, é interessante colocar algum resultado gerado pelo R no meio do texto. Para isso usamos a estrutura formada por uma crase seguida da letra r, o código e depois uma outra crase.

Por exemplo, vamos supor que eu queira colocar o valor da raiz quadrada de 76 em uma frase. Eu posso abrie um chunck e salvar em um objeto a raiz quadrada de 76 ou posso colocar o código sqrt(76) dentro da estrutura explicada anteriormente.

Logo, a raiz quadrade de 76 é 8.7177979.

9 Adicionando blocos de códigos

A gente também pode adicionar blocos de códigos a fim de exibição. Eles não serão processados. A estrutura é formada por 3 crases, em seguida o código, e depois mais três crases.

rq76 <- sqrt(76)

Viu como fica bonitinho?

O mesmo pode ser feito dentro do texto, mas aí basta uma crase no início e outra no fim da palvra ou texto desejado.

10 Adicionando fórmulas

Sendo um texto científico, é bem comum que você adicione umas fórmulas, não é mesmo? Para isso usaremos dois cifrões antes e dois cifrões no final da equação. Perceba que ao colocar os dois cifrões, o texto muda de cor.

\[ x = 2 + y \]

Se você desejar usar expressões próprias de equações, você precisará usar este material de apoio. O link mostra todos os símbolos disponíveis. Por exemplo, se eu que quiser escrever a letra grega alfa, usamos a contra-barra seguida da palavra alpha entre os cifrões.

\[ \alpha \]

11 Adicionando quebra de seção

Que tal uma quebra de seção? Basta colocar três ou mais asteriscos ou três ou mais tracinhos.

Vai aparecer uma linha bem fininha. Consegue ver?

12 Adicionando tabelas

12.1 Tabelas geradas manualmente

E agora chegamos nas tabelas! Talvez dê um pouco de trabalho, mas elas ficam lindas. A estrutura é formada por barras verticais e tracinhos. A ideia é desenhar a tabela.

Coluna 1	Coluna 2
Item 1	Item 3
Item 2	Item 4

Mas e se eu quero ajustar os itens da minha tabela. Para isso usamos dois pontos. Para centralizar, colocamos dois pontos no início e no fim dos tracinho. Se desejamos à esquerda, colocamos à esquerda, e se queremos à direita, os dois pontos ficam à direita.

Coluna 1	Coluna 2	Coluna 3
Item 1	Item 3	Item 5
Item 2	Item 4	Item 6

12.2 Tabelas a partir de códigos do R

Neste caso, se temos um banco de dados do R e queremos exibir uma tabela formatada desses dados, iremos usar o pacote knitr. Vamos adicionar dentro do chunk o código results='asis' para garantir que a tabela bruta não seja exibida. Precisamos carregar o pacote e usar a função kable. Vejamos:

library(knitr)
kable(iris[1:10,], caption = "Tabela 1. Título da tabela")

Tabela 1. Título da tabela
Sepal.Length	Sepal.Width	Petal.Length	Petal.Width	Species
5.1	3.5	1.4	0.2	setosa
4.9	3.0	1.4	0.2	setosa
4.7	3.2	1.3	0.2	setosa
4.6	3.1	1.5	0.2	setosa
5.0	3.6	1.4	0.2	setosa
5.4	3.9	1.7	0.4	setosa
4.6	3.4	1.4	0.3	setosa
5.0	3.4	1.5	0.2	setosa
4.4	2.9	1.4	0.2	setosa
4.9	3.1	1.5	0.1	setosa

13 Adicionando rodapés

Para colocarmos um rodapé, escrevemos o que desejamos, seguido de um colchete, um acento circunflexo e um número (seguindo a ordem dos que já foram usados). Em seguida, usamos a mesma estrutura acompangada de dois pontos com o texto ¹ do rodapé.

14 Transformando em apresentações de slides

Você também pode transformar seu documento em uma apresentação de slides.

output: ioslides_presentation criará uma apresentação de slides do ioslides (HTML5).
output: beamer_presentation criará uma apresentação de slides do beamer (PDF).
powerpoint_presentation criará uma apresentação de slides do PowerPoint (PPT)

Basta acresentar um desses comandos lááá no início do seu arquivo, em output. Para separar os slides, utilize a estrutura de três asteriscos ou três tracinhos.

15 Mudando o layout do arquivo

Se você observar a barra onde estão localizados os botões para salvar, inserir chunk e gerar o arquivo, você verá um desenho de engrenagem. Lá é onde poderemos editar alguns detalhes no layout do nosso arquivo. Aproveite para testar. Clique na engrenagem e, em seguida, Output Options…. Lá você poderá incluir um sumário, mudar o estilo do texto e dos destaque, mudar o tamanho das imagens, entre outros.

16 Controlando as saídas do chunk

Assim como o results=‘asis’ que vimos na formatação de tabelas com kable, temos outros argumentos para controlar as saídas geradas pelos códigos do R. Vejamos alguns:

echo = FALSE: suprime a impressão do código R.
eval = TRUE: avalia (executa) o fragmento de código R. Pode ser definido como vetor de números para avaliar apenas linhas específicas do código, por exemplo, eval = 1:3 avalia apenas as 3 primeiras linhas de código.
include = TRUE: inclui o código R e a saída no documento. Difere de eval porque se include = FALSE, o código R ainda é avaliado, mas nada é impresso no documento.
results = ...: como imprimir os resultados.
- ‘markup’: imprime a saída com formatação especial por tipo de documento.
- ‘hide’: suprime a impressão da saída.
- ‘hold’: imprime toda a saída de todo o trecho de código junto no final.
- ‘asis’ imprime resultados brutos sem formatação especial.
messag = FALSE: não imprime mensagens no documento.
warning = FALSE: não imprime avisos no documento.

Esses são alguns comandos básicos do RMarkdown. Para configurações mais avançadas, sugiro utilizar materiais compartilhados em fóruns de discussões como o Stackoverflow.

Eis um rodapé.↩︎

Meu Primeiro RMarkdown

Letícia Martins Raposo

24/05/2021