🎓 Resumo para Iniciantes
É uma forma de escrever texto formatado usando só o teclado. Em vez de clicar em 'negrito' no Word, você coloca dois asteriscos em volta da palavra. Simples, rápido e funciona em qualquer lugar.
O que é?
Markdown é uma linguagem de marcação leve criada por John Gruber em 2004 com o objetivo de ser fácil de escrever e fácil de ler mesmo como texto puro — diferente do HTML, que é funcional mas pouco legível sem processamento.
Um arquivo Markdown (.md) é texto simples com convenções de formatação que qualquer processador Markdown converte para HTML ou outros formatos.
Sintaxe básica
# Título H1
## Título H2
**negrito**
*itálico*
- item de lista
- outro item
1. lista numerada
2. segundo item
[texto do link](https://url.com)
`código inline`
```
bloco de código
```
> citação / blockquotePor que Markdown importa hoje
Markdown se tornou o formato padrão de fato em vários contextos críticos:
- Documentação técnica: README de projetos no GitHub, wikis, docs de API
- Geração de conteúdo estático: Blogs e sites construídos com ferramentas como Astro, Hugo, Jekyll processam conteúdo em Markdown
- Interfaces de IA: ChatGPT, Claude, Gemini e outros LLMs usam Markdown nas respostas — títulos, listas, tabelas e blocos de código são renderizados diretamente
- Ferramentas de colaboração: Notion, Linear, GitHub Issues, Slack e muitas outras plataformas aceitam Markdown
- E-mail e newsletters: Ferramentas como Substack e ConvertKit suportam Markdown na composição
Markdown no e-commerce
- Descrições de produto: Plataformas headless frequentemente armazenam rich text em Markdown
- CMS headless: Contentful, Sanity e Prismic usam Markdown ou MDX para conteúdo editorial
- Documentação interna: Runbooks, SOPs e guias de operação escritos em Markdown vivem bem no Git
- Prompts de IA: Instruções para LLMs usam Markdown para estruturar regras, personas e fluxos de trabalho
Variantes populares
| Variante | Contexto |
|---|---|
| CommonMark | Especificação padronizada, base para a maioria das implementações |
| GitHub Flavored Markdown (GFM) | Adiciona tabelas, tarefas, syntax highlight |
| MDX | Markdown com suporte a componentes React — muito usado em sites Astro/Next.js |
Biblioteca do Arquiteto
Archie (O Bibliotecário)
CURADOR"Eu li todos eles. A maioria é lixo. Estes aqui são os que sobraram na minha prateleira depois de 30 anos codando."