Lição 1
O que é Markdown?
Entenda Markdown como formatação em texto puro para README, docs, issues e changelogs.
Markdown é um formato de texto puro para escrever documentos estruturados sem tags HTML. Em vez de <h1>Título</h1>, você escreve:
# Título
Em vez de <strong>importante</strong>, você escreve:
**importante**
A ideia é simples: manter a fonte legível como texto, mas deixar ferramentas renderizarem títulos, listas, links e blocos de código.
Onde desenvolvedores usam Markdown
Markdown aparece constantemente no fluxo de trabalho:
README.mdem repositóriosCHANGELOG.mdcom notas de release- Corpos de issues e pull requests no GitHub
- Sites de docs que aceitam arquivos
.md - Notas de RFC, runbooks e guias internos
- Campos de CMS ou e-mail que aceitam HTML convertido a partir de Markdown
Markdown vs HTML vs editores WYSIWYG
| Formato | Ponto forte | Uso típico |
|---|---|---|
| Markdown | Rascunho rápido em texto puro, amigável a diff | README, issues, fonte de docs |
| HTML | Controle total de layout e estilo inline | CMS, e-mail, páginas web |
| WYSIWYG | Edição visual | Notion, Confluence, alguns CMS |
A maioria das equipes mantém Markdown no Git porque funciona bem com controle de versão, code review e copiar/colar entre ferramentas.
Resumo
Markdown é um formato de escrita, não um tema ou renderizador. O mesmo arquivo Markdown pode parecer diferente no GitHub, em um site de docs ou em uma ferramenta de visualização, dependendo do renderizador e do CSS.
Experimente a ferramenta Visualizar Markdown / Markdown para HTML com um README curto para ver como o texto-fonte vira saída renderizada.