Guia Markdown

Uma linguagem de marcação simples mas poderosa.

Introdução  

Markdown é uma linguagem de marcação leve criada em 2004 por John Gruber  , com contribuições significativas de Aaron Swartz  . O objetivo é fornecer uma maneira simples e legível de formatar texto, que pode ser convertido facilmente para HTML.

Diferente de editores WYSIWYG , como o Microsoft Word, em Markdown você adiciona elementos de formatação diretamente no texto. Por exemplo, para destacar uma palavra ou frase em itálico, você coloca um asterisco antes e outro depois dela.

Aqui está um exemplo de um texto formatado em Markdown:

Este é um parágrafo. Markdown é legal!

> Esta é uma citação: *miau*, *miau* 😸

Mas como esse texto é convertido em HTML?

Para escrever em Markdown você pode usar qualquer editor de textos (até mesmo o bloco de notas). No entanto, para que o texto seja convertido em HTML, você irá precisar de um aplicativo que processa o arquivo markdown e renderiza o seu conteúdo a fim de ser exibido na tela ou impresso.

Felizmente, há muitas opções de ferramentas  que realizam essa tarefa. Para acompanhar esse tutorial você pode utilizar o Dillinger  , um editor online intuitivo e versátil.

Aplicações  

Markdown está presente em muitas plataformas e ferramentas. Seu sucesso se deve à simplicidade e à clareza da sintaxe, permitindo que o conteúdo seja escrito em texto puro e interpretado em ambientes digitais com mínima complexidade.

Um dos exemplos de uso mais populares para a linguagem Markdown é na documentação de projetos em plataformas como GitHub e GitLab. Outra aplicação muito comum é na criação de blogs e sites estáticos, na qual o Markdown é a linguagem padrão para formatar o conteúdo. Muitos editores de texto e fóruns online também suportam Markdown, a exemplo do Reddit e Discord, permitindo que os usuários formatem seus textos e mensagens de maneira prática.

Podemos ainda encontrá-lo em:

• Livros: Autores podem usar Markdown para escrever e formatar livros e e-books, que podem então ser convertidos para formatos finais, como EPUB ou PDF.

• Anotações: Aplicativos de notas, como o Obsidian e o Typora, utilizam Markdown como a linguagem padrão para a criação e organização de notas.

• Artigos acadêmicos: Para a escrita de artigos, tutoriais e publicações acadêmicas, Markdown, combinado com ferramentas como Pandoc, pode ser convertido para diversos formatos, mantendo uma estrutura simples e versionável.

Esses são alguns dos inúmeros usos do Markdown, destacando sua flexibilidade e simplicidade, que o tornam uma escolha popular para formatação de texto em diversos contextos.

Sintaxe  

A seguir, apresentamos os principais elementos da sintaxe Markdown.

Títulos  

Para criar títulos, utilize o símbolo de hashtag seguido de um espaço. O número de hashtags determina o nível do título (<h1> a <h6> em HTML):

# Título de Nível 1
## Título de Nível 2
### Título de Nível 3
#### Título de Nível 4
##### Título de Nível 5
###### Título de Nível 6

Parágrafos  

Para criar um parágrafo, use uma linha em branco para separar uma ou mais linhas de texto:

Não coloque tabulações ou espaços no começo dos parágrafos.

Mantenha as linhas alinhadas à esquerda, dessa maneira.

Quebras de Linha  

Para criar uma quebra de linha (<br> em HTML), termine a linha com dois ou mais espaços:

Esta é a primeira linha.  
E esta é a segunda linha.

Ênfase  

Você pode destacar uma palavra ou frase em Markdown com itálico e negrito.

Itálico  

Para tornar o texto itálico (<em> em HTML), adicione um asterisco ou underscore antes e depois do texto:

O gato faz *miau-miau*.  
O cachorro faz _au-au_.

Negrito  

Para tornar o texto negrito (<strong> em HTML), adicione dois asteriscos ou underscores antes e depois do texto:

Amar é encontrar a **alma**.  
Contigo, o amor é __infinito.__

Citações  

Para criar uma citação, adicione um símbolo de maior que na frente do parágrafo:

> Somos feitos de poeira estelar. - Carl Sagan

Citações em Bloco  

Citações podem conter muitos parágrafos, desta maneira:

> Guerra é paz. Liberdade é escravidão. Ignorância é força.
>
> O Grande Irmão está te observando.

Citações Aninhadas  

Citações podem estar dentro de outras citações. Adicione dois símbolos de maior que na frente do parágrafo que deve ser aninhado:

> Se meus cálculos estiverem corretos...
>
>> Great Scott!

Listas  

Você pode organizar itens em listas.

Listas Ordenadas  

Para criar uma lista ordenada (<ol> em HTML), adicione um número seguido de um ponto. Os números não precisam estar em ordem, mas a lista deve começar com o número um. Recue à direita (adicione espaços) um ou mais itens da lista para criar uma lista aninhada:

1. Primeiro item
2. Segundo item
3. Terceiro item
4. Quarto item
---
1. Primeiro item
1. Segundo item
1. Terceiro item
1. Quarto item
---
1. Primeiro item
   1. Primeiro subitem
   2. Segundo subitem
2. Segundo item

Listas Não Ordenadas  

Para criar uma lista não ordenada (<ul> em HTML), você pode utilizar híphens, asteriscos ou símbolos de mais:

- Uva 🍇
- Coco 🥥
- Morango 🍓
---
+ Melancia 🍉
+ Abacaxi 🍍
+ Kiwi 🥝
---
* Laranja 🍊
* Pera 🍐
* Maçã 🍎

Listas de Tarefas  

Para criar uma lista de tarefas, adicione um híphen e colchetes com um espaço na frente do item da lista. Para marcar um item, adicione um x entre os colchetes:

- [x] Escrever um artigo sobre SEO básico
- [ ] Publicar no blog
- [ ] Responder emails

Listas de Definição  

Em alguns editores de Markdown você pode criar listas de definição (<dl> em HTML). Para criar uma, digite o termo na primeira linha. Na linha seguinte, insira dois pontos seguidos de um espaço e a definição do termo:

HTML
: HyperText Markup Language

CSS
: Cascading Style Sheets
: Outra definição de CSS

Código  

Para indicar uma palavra ou frase como código, coloque-a entre acentos graves:

Digite `nano` na linha de comando.

Blocos de Código  

Para criar blocos de código, recue cada linha do bloco com pelo menos quatro espaços (ou uma tabulação) ou, ainda, utilize três acentos graves:

<html>
    <h1>Título</h1>
</html>

```html
<html>
    <h1>Título</h1>
</html>
```

Linhas Horizontais  

Para criar uma linha horizontal, use três ou mais astericos, híphens ou underscores em uma linha separada:

Linha 1

***

Linha 2

---

Linha 3

___

Links  

Para criar um link, coloque o texto do link entre colchetes seguido da URL entre parênteses:

O meu motor de buscas preferido é o [Duck Duck Go](https://duckduckgo.com).

Tabelas  

Para adicionar uma tabela, use três ou mais hífens para criar o cabeçalho de cada coluna e use uma barra vertical para separar cada coluna. Por questões de compatibilidade, adicione uma barra vertical em cada extremidade da linha.

| Sintaxe     | Descrição   |
| ----------- | ----------- |
| Cabeçalho   | Título      |
| Parágrafo   | Texto       |

Notas de Rodapé  

Para criar uma referência a uma nota de rodapé, adicione um acento circunflexo e um identificador dentro de colchetes. Os identificadores podem ser números ou palavras, mas não podem conter espaços ou tabulações. Para criar a nota de rodapé, adicione outro acento circunflexo e o identificador da nota dentro de colchetes seguido de dois pontos:

Aqui está uma nota de rodapé simples,[^1] e aqui está uma mais longa.[^bignote]

[^1]: Esta é a primeira nota de rodapé.

[^bignote]: Aqui está uma com vários parágrafos e código.
    Recue os parágrafos para incluí-los na nota de rodapé.
    
    `{ meu código }`

    Adicione quantos parágrafos quiser.

Imagens  

Para adicionar uma imagem, adicione um ponto de exclamação, seguido de um texto alternativo entre colchetes, e o caminho ou URL da imagem entre parênteses. Opcionalmente, você pode também adicionar um título entre aspas:

markdown

![Melopsittacus undulatus](/assets/img/parakeets.jpg "Periquito Australiano")

Conclusão  

Markdown é uma linguagem de marcação simples mas poderosa que pode ser aprendida rapidamente. Sua adoção generalizada em uma ampla gama de aplicativos e plataformas a torna uma habilidade valiosa a ser adquirida.

Para aprofundar seus conhecimentos em Markdown, recomendamos que você pratique a criação de documentos, posts de blog e outras formas de conteúdo usando essa linguagem. Existem também muitos recursos online, como tutoriais e referências, que podem ajudá-lo a dominar ainda mais a sintaxe e os recursos avançados do Markdown.

✍️ Happy Writing!

Comentários