Markdown e a linguagem de marcacao mais usada para documentacao, README, blog posts e notas tecnicas. Com poucos caracteres, voce formata textos com titulos, listas, codigo, links e tabelas. O Markdown Preview mostra o resultado em tempo real.
Por que usar Markdown?
- simples de aprender;
- legivel no formato puro;
- universal (GitHub, Reddit, Stack Overflow, Notion, Discord);
- rapido para escrever documentacao;
- converte para HTML facilmente.
Sintaxe basica
Titulos
# Titulo 1
## Titulo 2
### Titulo 3
#### Titulo 4
Texto
Texto normal em paragrafo.
Negrito e italico e ambos.
Riscado e codigo inline.
Listas
- Item 1
- Item 2
- Subitem
- Subitem
- Primeiro
- Segundo
- Terceiro
Links e imagens
[texto do link](https://exemplo.com)
Codigo
Bloco inline: `codigo`
Bloco multiplas linhas:
```javascript
function hello() {
console.log("Hello World");
}
```
Citacoes
> Esta e uma citacao em bloco.
> Pode ter varias linhas.
Tabelas
| Coluna 1 | Coluna 2 | Coluna 3 |
|----------|----------|----------|
| Dados 1 | Dados 2 | Dados 3 |
| Dados 4 | Dados 5 | Dados 6 |
Linha horizontal
---
Checkbox
- [x] Tarefa concluida
- [ ] Tarefa pendente
Como usar o Markdown Preview
- Acesse o Markdown Preview;
- Digite ou cole seu texto Markdown no editor da esquerda;
- Veja o resultado formatado em tempo real na direita;
- Copie o HTML gerado ou exporte.
Onde Markdown e essencial
GitHub
README, issues, pull requests, wikis — tudo e Markdown.
Documentacao tecnica
API docs, guias de instalacao, changelogs.
Blog posts
Plataformas como Dev.to, Hashnode, Medium e Ghost aceitam Markdown.
Notas
Obsidian, Notion, Bear, Joplin — todos usam Markdown como base.
Chat
Discord, Slack e Telegram suportam Markdown em mensagens.
Markdown avancado
Tabelas com alinhamento
| Esquerda | Centro | Direita |
|:---------|:------:|--------:|
| texto | texto | texto |
Listas de tarefas
- [x] Implementar feature
- [ ] Escrever testes
- [ ] Deploy
Footnotes
Texto com nota de rodape[^1].
Emoji
:smile: :rocket: :heart:
Mencao de usuarios
@username
Markdown vs HTML
| Aspecto | Markdown | HTML |
|---|---|---|
| Simples | Sim | Nao |
| Legivel | Sim | Dificil |
| Flexibilidade | Limitada | Total |
| Uso ideal | Texto, docs | Paginas web complexas |
Markdown e um subconjunto de HTML. Voce pode misturar HTML dentro de Markdown quando precisar de mais controle.
Ferramentas que usam Markdown
- GitHub: README, issues, PRs;
- VS Code: documentacao, notas;
- Notion: blocos de texto;
- Obsidian: segunda cerebro;
- Jekyll/Hugo/Gatsby: geradores de blog estatico;
- Swagger/OpenAPI: documentacao de API;
- Docusaurus: documentacao de projetos.
Erros comuns
- Espaco na linha: listas precisam de linha em branco antes e depois;
- Indentacao: subitens precisam de 2 ou 4 espacos;
- Tabelas sem separador: a linha
|---|---|e obrigatoria; - Links sem protocolo: use
https://, naowww.; - Imagens sem alt: sempre inclua texto alternativo.
Perguntas frequentes
Markdown e uma linguagem de programacao? Nao. E uma linguagem de marcacao leve para formatacao de texto.
Posso usar Markdown em e-mails? A maioria dos clientes de e-mail nao renderiza Markdown. Use HTML ou texto puro.
Markdown funciona offline? Sim. O arquivo .md e texto puro. O Markdown Preview precisa de conexao para renderizar no navegador.
Qual a diferenca entre Markdown e MDX? MDX e Markdown com suporte a componentes React. Usado em documentacao interativa.
Markdown suporta matematica? Variantes como MathJax e KaTeX adicionam suporte a formulas matematicas.
Teste seus textos agora no Markdown Preview e veja o resultado em tempo real.