Capítulo 5 Sintaxe Markdown

Como mencionado anteriormente, ao usar um arquivo *.Rmd temos a possibilidade de mesclar a linguagem de formatação de texto Markdown com códigos R. Vamos começar entendendo a sintaxe Markdown.

A sintaxe Markdown é toda relacionada à formatação de texto. Como vocês puderam observar ao renderizar o documento padrão (exercício anterior), o símbolo ## define que naquela linha estará o texto com um título de segunda ordem no nível hierarquico, já que o título de primeira ordem seria definido com apenas um #. A hierarquia de títulos é, portanto, definida pela sequência de #. Por exemplo, na figura :

• O texto “Elaboração de relatórios com RMarkdown” será o título do documento, por possuir apenas um #.
• Logo em seguida, será incluído um título de segunda hierarquia (subtítulo) com texto “Markdown” (já que o mesmo é precedido por dois #).
  
• A sequencia segue até satisfazer o nível hierarquico de títulos do seu documento;

Uma coisa bem legal desse sistema de formatação de texto é que, por ser declarativo por texto (ou comando em sintaxe Markdown), fica fácil colaborar com outras pessoas sem perder as configurações, além de deixar claro a estrutura do texto. Isso desde que sempre se edite o arquivo Rmd. Caso contrário isso dependerá dos conhecimentos dos usuários de softwares de eedição de texto, como o MS Word.

Outros elementos importantes para formatação de texto são:

• Negrito: Para colocar uma palavra ou frase em negrito, basta usar dois asterístico (**) para iniciar o trecho e dois asterístico para fechar o texto a ser enfatizado (ex.: **trecho em negrito**).
  
• Itálico: Similar ao negrito, mas usa-se apenas um asterístico no início e outro no fim (ex.: *trecho em italico*).
  
• riscado: Basta inserir dois tis (~~) ao início e outros dois ao fim do trecho a ser riscado (ex.: ~~trecho riscado~~);

Pontos importantes:

Os elementos de formatação de texto, como negrito, italico, riscado, dentre outros, deverão ser seguidos por texto, sem espaço entre o elemento de formatação e o texto a ser formatado. Contudo, já com relação aos títulos, é necessário dar espaço entre o # e o texto a receber a formatação de titulo.

5.0.1 Exercício II (Sintaxe markdown)

1. Colocar todo o primeiro parágrado como riscado;
2. Colocar algumas paravras em negrito;
   
3. Colocar outras palavras em intálico;
   
4. Alterar a hierarquia dos títulos;
   
5. Cria um novo título de primeira hierarquia;
   
6. Renderize em formato PDF. Analise o indice do documento. Obedeceu a hierarquia definida?
   
7. Renderize em formato .doc. Analise o indice do documento. Obedeceu a hierarquia definida?