C.2 Markdown

C.2.1 Cabeçalhos

Cabeçalhos (ou headers em inglês) são definidos para construção do índice de seções ou capítulos do documento (table of content, TOC) que são 'lincados' às seções.

 # Seção - nível 1
 ## Subseção - nível 2 
 ### Subsubseção - nível 3
 e assim por diante
 ...

C.2.2 Parágrafos

Um parágrafo é uma ou mais linhas de texto, seguido de uma ou mais linha em branco.

Novas linhas são tratadas como espaços, para que possa organizar seus parágrafos como você gosta.

Se você precisar de uma quebra de linha, insira dois ou mais espaços no final de uma linha.

C.2.3 Listas

Para produzir uma lista são usados os símbolos: + , * , -. Uma lista suporta vários níveis de subitens. Os subitens devem separados por quatro espaços ou um tab.

 * um
     - subitem
 * dois
     - subitem
         - subsubitem
 * três
  • um
    • subitem
  • dois
    • subitem
      • subsubitem
  • três

C.2.4 Linhas horizontais

Para inserir uma linha horizontal pode-se usar:

 
 * * *
 
 ou
 
 - - -

Ambos serão impressos como:

É importante notar a quebra de linha entre cada linha de caracteres.

C.2.5 Citações diretas

Para fazer citações diretas é só acrescentar um > antes do texto da citação. Por exemplo:

> É eRReando que se aprende R. (Jônatan Tatsch).

será impresso no HTML assim:

É eRReando que se aprende R. (Jônatan Tatsch).

C.2.6 Tabelas

As tabelas devem ter uma linha para cada fila, com alinhamento definido pela posição relativa a linha pontilhada dos nomes das colunas. A descrição da tabela precisa ter o formato Table: ou apenas :, a posição definida é acima da tabela.

  direita     esquerda   Centro    Default
  -------     ------   ---------   -------
       12     12          12           12
      123     123         123         123
        1     1            1            1
  Table:  Tabela 1. Demonstração da sintaxe para uma tabela.
Tabela 1. Demonstração da sintaxe para uma tabela.
direita esquerda Centro Default
12 12 12 12
123 123 123 123
1 1 1 1 
#> : Amostra de tabela com grades.
#>                                
#> +---------------+---------------+--------------------+
#> | Variável1     | Variável2     | descrição          |
#> +===============+===============+====================+
#> | 1             |  1.34         | - Observação 1     |
#> |               |               | - Observação 2     |
#> +---------------+---------------+--------------------+
#> | 2             |  2.10         | - Observação 2     |
#> |               |               | - Linha 2          |
#> +---------------+---------------+--------------------+
Amostra de tabela com grades.
Variável1 Variável2 descrição

1

1.34
  • Observação 1
  • Linha 1

2

2.10
  • Observação 2
  • Linha 2

Um recurso para construir tabelas em Markdown é o gerador de tabelas que permite montar a tabela e criar o código para você colá-lo no seu documento .Rmd.

C.2.7 Ênfase de texto

Para destacar texto usa-se geralmente as palavras em itálico (_itálico_ ou *itálico*) ou em negrito (__negrito__ ou **negrito**).

Um texto sobrescrito 210 é escrito 2^10^ e o subscrito (H2O) da forma H~2~O.

C.2.9 Figuras

Para a inserir figuras o procedimento é quase o mesmo de um link, só que precedido pelo símbolo !.

Vamos criar um link para o endereço da imagem:

[Cachoeira do Abade](http://upload.wikimedia.org/wikipedia/commons/c/c5/Cachoeira_do_Abade_AGO_2008.jpg)

Cachoeira do Abade

Ao acrescentarmos o símbolo ! no início, obtemos a imagem no documento.

![Cachoeira do Abade](http://upload.wikimedia.org/wikipedia/commons/c/c5/Cachoeira_do_Abade_AGO_2008.jpg)
Figura 1. Cachoeira do Abade

Figura 1. Cachoeira do Abade

O procedimento para inserir figuras do seu computador é o mesmo, só altera-se o endereço pelo caminho até o arquivo.

C.2.10 Expressões matemáticas

Nossa área de estudo geralmente requer análises baseadas em equações. Para inserir expressões matemáticas no R Markdown é da mesma forma usada em Latex.

Para expressões dentro de uma linha as equações são escritas entre os símbolos $ $, por exemplo, \(y=f(x)\) foi gerada com $y=f(x)$. Mas se a equação for muito complexa é melhor colocá-la sozinha entre parágrafos de texto, duplicando o mesmo símbolo $$ $$, exemplo:

 $$\psi = \psi_e \left(\dfrac{\theta}{\theta_s}\right)^{-b}$$

produz:

\[\psi = \psi_e \left(\dfrac{\theta}{\theta_s}\right)^{-b}\]

Há também um Editor online de equações que fornece uma interface para escrever a equação e o código gerado pode ser colado no seu documento.