Guia de Sintaxe Markdown: Do Básico ao Avançado

Markdown é o formato de escrita que os desenvolvedores realmente gostam de usar. Sem precisar clicar em menus de formatação, sem lutar com editores WYSIWYG — apenas texto puro com alguns símbolos que se converte em HTML limpo. Arquivos README, documentação, posts de blog, mensagens de chat e até este artigo são escritos em Markdown.

Visualize seu Markdown em tempo real com nosso Previewer de Markdown — escreva de um lado e veja a saída formatada do outro.

Sintaxe Básica

Títulos

# Título 1
## Título 2
### Título 3
#### Título 4

Use títulos de forma hierárquica. Não pule níveis (saltar de H1 para H3) — isso prejudica tanto a legibilidade quanto a acessibilidade.

Ênfase

*itálico* ou _itálico_
**negrito** ou __negrito__
***negrito itálico***
~~tachado~~

Links e Imagens

[Texto do link](https://example.com)
[Link com título](https://example.com "Título")
![Texto alternativo](image.png)

Listas

- Item não ordenado
- Outro item
  - Item aninhado

1. Primeiro item
2. Segundo item
3. Terceiro item

Citações

> Isto é uma citação.
> Pode ocupar várias linhas.

Código

Código Inline

Use crases para código inline: `const x = 42`

Blocos de Código

Três crases com um identificador de linguagem opcional:

```javascript
function greet(name) {
  return `Hello, ${name}!`;
}
```

As linguagens suportadas incluem javascript, python, json, yaml, html, css, bash e muitas outras.

Tabelas

| Cabeçalho 1 | Cabeçalho 2 | Cabeçalho 3 |
|-------------|-------------|-------------|
| Célula 1    | Célula 2    | Célula 3    |
| Célula 4    | Célula 5    | Célula 6    |

Alinhamento:

| Esquerda | Centro | Direita |
|:---------|:------:|--------:|
| E        |   C    |       D |

Sintaxe Avançada

Listas de Tarefas

- [x] Tarefa concluída
- [ ] Tarefa pendente
- [ ] Outra tarefa

Notas de Rodapé

Aqui está uma afirmação[^1].

[^1]: Este é o conteúdo da nota de rodapé.

Listas de Definição

Termo
: Definição do termo

Linhas Horizontais

---
***
___

GitHub-Flavored Markdown (GFM)

O GitHub estende o Markdown padrão com recursos úteis:

• URLs com link automático — URLs sem formatação se tornam clicáveis
• Listas de tarefas — Caixas de seleção em issues e PRs
• Tabelas — A sintaxe com pipes mostrada acima
• Tachado — ~~texto deletado~~
• Destaque de sintaxe — Coloração de código específica por linguagem
• Emoji — :smile: se torna um rosto sorridente

Dicas de Escrita

• Mantenha parágrafos curtos — 3-5 frases no máximo
• Use títulos para criar uma estrutura escaneável
• Prefira listas a parágrafos longos para etapas ou recursos
• Adicione exemplos de código sempre que discutir conceitos técnicos
• Visualize regularmente — nosso Previewer de Markdown mostra a saída enquanto você digita

Perguntas Frequentes

Qual é a diferença entre Markdown e HTML?

Markdown é um formato de escrita simplificado que se converte em HTML. Ele cobre as necessidades de formatação mais comuns com muito menos sintaxe. Você pode incorporar HTML puro no Markdown quando precisar de recursos que o Markdown não suporta.

Qual variante de Markdown devo usar?

GitHub-Flavored Markdown (GFM) é a mais amplamente suportada. Ela adiciona tabelas, listas de tarefas e tachado ao Markdown padrão. CommonMark é a especificação padronizada.

Posso usar Markdown para documentação?

Com certeza. Markdown é o padrão para arquivos README, wikis e sites de documentação. Ferramentas como MkDocs, Docusaurus e GitBook todas utilizam Markdown.

Recursos Relacionados

• Markdown vs Rich Text — por que desenvolvedores preferem texto puro
• Text Diff Checker — compare arquivos Markdown
• Previewer de Markdown — visualize Markdown em tempo real
• Ferramenta Text Diff Checker — compare arquivos de texto e Markdown