Guia para iniciantes da sintaxe R Markdown

Você provavelmente já conhece a linguagem de marcação Markdown leve. Consulte nosso Guia de Markdown, se você é novo no conceito. No geral, é uma linguagem simples e eficaz para criar documentos de texto simples.

No entanto, Markdown pode não ser suficiente para fazer relatórios detalhados ou documentos técnicos.

Assim, R Markdown como um formato de arquivo interativo surgiu em 2014 graças a pacotes como knitr e Pandoc. Ele combina texto sem formatação com código R in-line, ajudando você a criar um documento dinâmico.

Para criar documentos R Markdown, você pode usar vários IDEs e extensões para torná-lo possível. No entanto, o IDE oficial que ajuda você a fazer isso é o RStudio. Então, neste artigo, vamos nos concentrar em aprender a sintaxe R Markdown usando RStudio.

Se você não sabia, a linguagem de programação R é usada para computação estatística, representação gráfica e relatórios.

Configuração do RStudio

O RStudio facilita o trabalho com o R Markdown pelo seu processo de configuração. Você só precisa instalar um pacote, e está pronto!

Depois de instalar o RStudio, vá para o menu Ferramentas e selecione a opção Instalar pacotes.

Selecione a opção Instalar pacotes no menu Ferramentas

Na nova caixa de diálogo, procure por rmarkdown e instale-o.

Instalar o pacote RMarkdown

Para usar blocos de código como Python, você precisa instalar pacotes adicionais. O RStudio solicitará que você instale os pacotes necessários quando você tentar incluí-los em seu documento.

Uma vez instalado, você pode iniciar um novo documento rmarkdown selecionando File - New - RMarkdown.

Criar um novo documento RMarkdown

Isso solicitará que você adicione algumas informações sobre o documento (metadados para o arquivo). Preencha-os.

Novo documento em rmarkdown

Ou você pode criar um documento vazio para começar do zero.

Sintaxe RMarkdown

Como é apenas um "Markdown melhorado", a maior parte da sintaxe permanece a mesma.

Haveria algumas diferenças quando você adiciona coisas geralmente não suportadas com Markdown, como tabelas, equações matemáticas, blocos de código, etc.

Aqui está um breve resumo do que abordaremos:

Nome do bloco RMarkdown	Sintaxe adequada
Títulos	`# Nível 1 ## Nível 2 ### Nível 3 Nível 1 ======= Nível 2 -------`
Ênfase	`Itálico _Itálico_ Negrito __Negrito__`
Listas	Lista não ordenada `Item Item + Sub + Sub` Lista ordenada `1. Item 2. Item + Sub + Sub`
Blocos de código	Bloco de código normal ``` Código fica entre estes três apostrofos ``` Bloco de código R ```{r} Código R ``` Você pode usar outras linguagens também `código` inline
Links	Link simples: `cole a URL` Link com âncora: `[âncora](endereço URL)` Link para uma seção: `[âncora](#Nome-da-seção)`
Tabela	`\| Coluna \| Coluna \| Coluna \| \| ------ \| ------ \| ------ \| \| Item \| Item \| Item \| \| Item \| Item \| Item \|`
Equações	Equações inline: $Equação$ Equações em nova linha: `$$Equação$$`
Imagens	Sem legenda: `![](link_para_a_imagem)` Com legenda: `![Legenda](link_para_a_imagem)`
Blocos de citações	`> Citação`
Outros	Sobrescrito: `Texto ^sobrescrito^` Linha horizontal ou quebra de página: `======` `-------` Termine a linha com dois espaços em branco ( )

O cabeçalho YAML

Na parte superior de um documento Rmarkdown, há um cabeçalho YAML dentro de dois ---. Esse bloco geralmente contém um título, autor, data e o tipo de arquivo que você deseja produzir, definindo a aparência final do documento.

O tipo de arquivo é HTML, PDF ou Word.

---
title: "Teste"
author: "é Livre e Aberto"
date: "2023-06-18"
output: pdf_document
---

Isso pode ser adicionado ao definir o novo documento no RStudio, que é mostrado na seção acima.

Título

Em R Markdown, podemos dar título em dois métodos diferentes. Ou podemos usar o caractere # para diferentes níveis de título como:

# Título nível 1
## Título nível 2
### Título nível 3
#### Título nível 4
##### Título nível 5
###### Título nível 6

Ou, = e - para títulos de nível 1 e 2, respectivamente.

Título de nível 1
=================

Título de nível 2
-----------------

Vários tipos de níveis de título no arquivo RMarkdown

Listas

Existem dois tipos de listas, a primeira é uma lista não ordenada, ou você pode chamá-las de bullet points:

* Item 1
* Item 2
        + Sub 1
        + Sub 2
* Item 3

E o segundo é a lista ordenada, que é o tipo numerado:

1. Item 1
2. Item 2
        + Sub 1
        + Sub 2
3. Item 3

Exemplo de lista ordenada e não ordenada

Formatar texto dentro de um parágrafo

Há várias maneiras de formatar texto.

Exemplos de formatação de texto

Você pode adicionar ênfase ao texto como itálico ou negrito usando:

Itálico: Coloque o texto entre asteriscos simples ou sublinhado simples
Negrito: Coloque o texto entre asteriscos duplos ou sublinhados duplos.

*Este texto está em itálico*
_Este texto está em itálico_

**Este texto está em negrito**
__Este texto está em negrito__

Se você quiser adicionar sobrescrito a um texto, coloque o texto que deve ser sobrescrito entre ^ símbolo.

Texto normal

Texto ^sobrescrito^

Ou, se quiser adicionar texto riscado, coloque o texto entre dois símbolos de ~~.

~~Texto riscado~~

Texto sobrescrito e riscado

Adicionando blocos de código

A incorporação de código é o objetivo principal do R Markdown. Ele nos permite adicionar códigos de várias maneiras.

Adicionando bloco de código normal.

Se você quiser adicionar um bloco de código normal para separá-lo de outro texto, use a sintaxe abaixo:


```
Seu código vai aqui
```

Você deve acrescentar a linguagem em chaves se quiser adicionar código e incorporar sua saída ao documento:


```{linguagem}
Seu código vai aqui
```

Ou, você pode adicionar códigos inline colocando o respectivo texto entre os símbolos de apóstrofo ( ` ).

O `codigo` é um código

Veja como deve ser:

Blocos de código

Links

Para adicionar um link como texto sem formatação, basta colar o link como ele está em uma linha.

https://livreeaberto.com

Ou, para criar um hiperlink de texto, use a sintaxe:

[Texto](Endereço)

Outra maneira de adicionar um link é, quando você deseja vincular a uma seção da página. Nesse caso, use a sintaxe:

[Texto](#Nome-da-seção)

Links em rmarkdown

Tabelas

A sintaxe para adicionar tabelas é semelhante à de markdown.

|Coluna|Coluna|Coluna|
| --- | --- | --- |
|Item|Item|Item|
|Item|Item|Item|

Tabelas em rmarkdown

Imagens

Para adicionar uma imagem, use a sintaxe:

![](http://exemplo.com/logo.png)

![Texto de legenda](http://exemplo.com/logo.png)

Imagem em rmarkdown

Blocos de citações

RMarkdown permite que você adicione blocos de citações. Para usar isso, use o símbolo > (maior que) na frente da linha/parágrafo que você deseja citar.

Este é um texto normal

> Mas este é um texto de citação

Texto de citação no rmarkdown

Equações

Usando RMarkdown, você pode adicionar equações ou exibir equações LaTex complexas.

Por exemplo:

Equações inline ficam assim: $Equação$

Equações em uma nova linha ficam assim:
$$Equação$$

Adicionando equações no documento R Markdown

Linha Horizontal/Quebra de Página

Use três ou mais asteriscos ou traços para adicionar uma regra horizontal/quebra de página.


************

------------

Se você quiser adicionar uma quebra de linha manual, termine essa linha com dois ou mais espaços.

Resumo

R Markdown é útil

Se você está trabalhando com relatórios científicos ou deseja criar qualquer outro tipo de documento dinâmico, o R Markdown é sua melhor aposta para aproveitar ao máximo o Markdown.

Perdemos algo que você usa com R Markdown? Compartilhe seus pensamentos nos comentários abaixo.

Via itsfoss.com. Você pode conferir o post original em inglês:

Beginner's Guide to R Markdown Syntax [With Cheat Sheet]