Markdown: Um breve resumo
Markdown é uma linguagem de marcação leve criada em 2004 por John Gruber e Aaron Swartz. O objetivo central é permitir a escrita em formato de texto simples legível para humanos, convertendo-o de forma previsível em HTML estruturado.
Neste artigo, eu busco apresentar, de forma resumida e organizada, um guia de estudo contendo os principais comandos para quem está iniciando na utilização desse formato.
Como Funciona
- Escrita: O texto é digitado em formato .md ou .markdown com caracteres convencionais do teclado (#, *, -, []).
- Processamento: Um analisador (parser) lê esses caracteres de pontuação e mapeia cada elemento para a tag HTML correspondente.
- Renderização: O visualizador exibe o documento com estilização visual (títulos grandes, texto em negrito, tabelas alinhadas, blocos de código formatados).
Elementos Básicos
Os blocos fundamentais para formatação de documentos padrão:
Cabeçalhos
O caractere # define o nível hierárquico do cabeçalho (equivalente a <h1> até <h6> em HTML):
# 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
Ênfase no Texto
Estilos aplicados a palavras ou trechos:
*Texto em itálico* ou _Texto em itálico_
**Texto em negrito** ou __Texto em negrito__
***Texto em negrito e itálico***
~~Texto tachado~~
Listas
Listas ordenadas, não ordenadas e com marcadores:
Lista não ordenada
- Item A
- Item B
- Subitem B.1
- Subitem B.2
* Alternativa com asterisco
Lista ordenada
1. Primeiro passo
2. Segundo passo
3. Terceiro passo
Links e Imagens
A sintaxe de imagens adiciona um ponto de exclamação ! no início da estrutura de link:
[Texto visível do link](https://exemplo.com "Título opcional ao passar o mouse")
Citações em Bloco (Blockquotes)
O símbolo > cria blocos de destaque para referências ou citações:
> Esta é uma citação em bloco.
>
> Pode ter múltiplos parágrafos e outros elementos dentro dela.
>> Citação aninhada.
Divisores Horizontais
Criados com três ou mais hífens, asteriscos ou underscores em uma linha isolada:
---
***
___
Elementos Intermediários
Extensões comuns padronizadas pela especificação GitHub Flavored Markdown (GFM):
Código e Destaque de Sintaxe
Inline code usa crases simples; blocos de código usam três crases seguidas da linguagem para coloração:
Para imprimir no console, use `console.log()`.
```python
def saudacao(nome: str) -> str:
return f"Olá, {nome}!"
print(saudacao("Mundo"))
```
Tabelas
As colunas são delimitadas por barras verticais |. A linha divisória usa dois-pontos : para controlar o alinhamento (à esquerda, ao centro ou à direita):
| Item | Descrição | Preço |
| :--- | :---: | ---: |
| Teclado | Mecânico ABNT2 | R$ 350,00 |
| Mouse | Sensor óptico | R$ 180,00 |
| Monitor | 27 polegadas 144Hz | R$ 1.200,00 |
Listas de Tarefas (Task Lists)
Checkboxes úteis para controle de pendências e planejamento:
- [x] Configurar ambiente local
- [ ] Criar testes unitários
- [ ] Publicar em produção
Elementos Avançados
Recursos dependentes do parser do ambiente (GitHub, GitLab, Obsidian, Notion, plataformas de documentação):
Notas de Rodapé (Footnotes)
Criam marcadores clicáveis no texto que direcionam para notas no final da página:
Esta frase tem uma referência específica[^1].
[^1]: Detalhes adicionais e fonte bibliográfica da referência.
Blocos de Detalhes Expansíveis (Acordeões)
Utilizam tags HTML nativas suportadas pela maioria dos interpretadores de Markdown:
<details>
<summary>Clique para ver a resposta</summary>
Este conteúdo fica oculto até o usuário clicar no sumário.
</details>
Fórmulas Matemáticas (KaTeX / MathJax)
Suportado em ambientes técnicos e acadêmicos. Usa cifrão simples $ para equações em linha e cifrão duplo $$ para equações em bloco:
A equação $E = mc^2$ relaciona energia e massa.
$$
\int_{-\infty}^{+\infty} e^{-x^2} dx = \sqrt{\pi}
$$
Diagramas com Mermaid
Muitos visualizadores modernos renderizam fluxogramas, gráficos e sequências diretamente a partir de blocos de texto:
```mermaid
graph TD
A[Início] --> B{Válido?}
B -- Sim --> C[Processar Dados]
B -- Não --> D[Exibir Erro]
C --> E[Fim]
D --> E
```
Boas Práticas e Regras de Sintaxe
- Quebra de linha: Para iniciar um novo parágrafo, deixe uma linha em branco completa. Duas quebras de espaço ao final da linha forçam uma quebra simples (<br>) em parsers convencionais.
- Escape de caracteres: Se precisar exibir um símbolo de Markdown como texto literal sem acionar formatação, insira uma barra invertida antes: \*este texto não fica em itálico\*.
- HTML dentro de Markdown: Markdown aceita código HTML puro (<div>, <span>, <b>, <kbd>Ctrl</kbd> + <kbd>C</kbd>). No entanto, o Markdown inserido dentro de blocos de HTML complexos pode não ser interpretado por parsers legados.
