Markdown Explicado em 5 Minutos

Você provavelmente já usou Markdown sem saber. Já digitou **negrito** em uma mensagem do Slack? Escreveu um README no GitHub? Formatou uma postagem no Reddit? Isso é Markdown.

Markdown é uma forma leve de formatar texto simples usando símbolos simples. Em vez de clicar em botões da barra de ferramentas para negrito, itálico, títulos e listas, você digita alguns caracteres que indicam a formatação desejada. Foi criado em 2004 por John Gruber e Aaron Swartz, e desde então se tornou a linguagem de formatação padrão para desenvolvedores, escritores e qualquer pessoa que trabalhe com texto na web.

Por Que o Markdown Existe

Antes do Markdown, formatar texto para a web significava escrever HTML. Para deixar uma palavra em negrito, você digitava <strong>negrito</strong>. Para criar uma lista, precisava de <ul><li>item</li></ul>. HTML é poderoso mas verboso e difícil de ler em sua forma bruta.

Markdown resolve isso fornecendo uma abreviação legível para humanos. O texto bruto é fácil de ler mesmo antes de ser renderizado. A saída formatada é limpa e profissional. Você obtém o melhor dos dois mundos: texto fonte legível e resultado polido.

A Sintaxe Essencial

Aqui está tudo o que você precisa saber para começar a usar Markdown de forma produtiva.

Títulos

Use símbolos de cerquilha (#) para criar títulos. Mais cerquilhas significam títulos menores.

# Título 1 (maior)
## Título 2
### Título 3
#### Título 4

Negrito e Itálico

Envolva o texto em asteriscos ou underscores:

**texto em negrito**
*texto em itálico*
***negrito e itálico***

Listas

Listas não ordenadas usam travessões, asteriscos ou sinais de mais. Listas ordenadas usam números.

- Primeiro item
- Segundo item
- Terceiro item

1. Primeiro passo
2. Segundo passo
3. Terceiro passo

Links

Colchetes para o texto, parênteses para o URL:

[Clique aqui](https://example.com)

Imagens

Como links, mas com um ponto de exclamação na frente:

![Texto alternativo](url-da-imagem.jpg)

Citações

Use o símbolo de maior-que:

> Isto é uma citação. Será indentada e estilizada de forma diferente.

Código

Crases para código inline, crases triplas para blocos de código:

Use a função `print()` para exibir texto.

Para blocos de código multilinha, use crases triplas com um identificador de linguagem opcional:

```python
def hello():
    print("Hello, world!")
```

Linhas Horizontais

Três ou mais travessões, asteriscos ou underscores:

---

Tabelas

Use barras verticais e travessões:

| Nome | Função | Localização |
| --- | --- | --- |
| Alice | Desenvolvedora | Berlim |
| Bob | Designer | Londres |

Onde o Markdown É Usado

Markdown está em toda parte:

Desenvolvimento de Software

• GitHub, GitLab, Bitbucket: READMEs, issues, pull requests e documentação são todos escritos em Markdown.
• Stack Overflow: Perguntas e respostas usam formatação Markdown.
• Documentação de código: Muitos geradores de documentação (Docusaurus, MkDocs, Jekyll) usam Markdown como formato fonte.

Comunicação

• Slack: Suporta um subconjunto de Markdown para formatação de mensagens.
• Discord: Usa Markdown para negrito, itálico, blocos de código e mais.
• Reddit: Postagens e comentários são formatados com Markdown.

Escrita e Publicação

• Blogs: Muitos geradores de sites estáticos usam arquivos Markdown como fontes de conteúdo.
• Livros: Várias ferramentas de publicação aceitam manuscritos em Markdown.
• Notas: Apps como Obsidian, Notion, Bear e Typora são construídos em torno do Markdown.

Documentação

• Documentação técnica: Documentação de API, guias de usuário e wikis comumente usam Markdown.
• Bases de conhecimento internas: Muitas equipes usam wikis baseadas em Markdown.

Variantes do Markdown

Uma coisa para saber: existem diferentes "variantes" de Markdown. A sintaxe básica é a mesma em todo lugar, mas algumas plataformas adicionam extensões:

As diferenças estão principalmente em recursos avançados. O básico (títulos, negrito, itálico, listas, links, imagens, código) funciona igual em todo lugar.

Erros Comuns

Esquecer Linhas em Branco

Markdown requer uma linha em branco antes e depois de muitos elementos. Um título precisa de uma linha em branco antes dele. Uma lista precisa de uma linha em branco antes e depois. Esquecer essas linhas em branco é a fonte mais comum de problemas de renderização.

Marcadores de Lista Inconsistentes

Misturar -, * e + na mesma lista pode causar renderização inesperada. Escolha um e mantenha.

Espaços Depois dos Símbolos

Alguns processadores Markdown exigem um espaço após o # em títulos e após - em listas. Sempre inclua o espaço para garantir.

# Título correto
#Título incorreto

- Item de lista correto
-Item de lista incorreto

Por Que Vale a Pena Aprender Markdown

Markdown leva cinco minutos para aprender e economiza horas ao longo do tempo. Uma vez que você o conhece, pode:

• Escrever documentação que fica bonita no GitHub
• Formatar mensagens no Slack e Discord sem tocar no mouse
• Fazer anotações estruturadas que são portáveis entre aplicativos
• Criar posts de blog e conteúdo web a partir de arquivos de texto simples
• Colaborar em documentos baseados em texto sem problemas de compatibilidade de formato

A relação investimento-retorno é uma das melhores em todo o mundo da tecnologia.

Comece a escrever em Markdown agora:

• Escrever e Visualizar Markdown
• Ferramenta de Visualização Markdown

Gratuito, no navegador, com visualização em tempo real enquanto você digita.