Markdown para HTML

Markdown: escrever documentos formatados sem complicacao

Markdown permite criar documentos bem formatados usando texto puro. Nada de menus, nada de briga com processador de texto. Um # para titulo, **asteriscos duplos** para negrito, um - para item de lista, e pronto. E o formato padrao no GitHub, Notion e na maioria das plataformas de blog.

Cola de Markdown: o essencial num relance

O basico e realmente simples. # gera um h1, ## um h2, e assim por diante ate ######. **negrito** e *italico* funcionam exatamente como voce espera. Listas com marcadores comecam com - ou *, listas numeradas com 1. 2. 3. Links se escrevem [clique aqui](https://example.com), imagens sao iguais mas com um ! na frente. Para codigo, envolva trechos inline com crases e use tres crases para blocos de codigo. Tabelas exigem um pouco mais de trabalho -- pipes (|) e hifens (-) -- mas sao perfeitamente viaveis.

Markdown esta literalmente em todo lugar

Se voce usa GitHub, ja esta escrevendo Markdown -- README, issues, descricoes de pull requests, tudo vai em Markdown. Notion, Obsidian e Slack tambem entendem atalhos Markdown. Geradores de sites estaticos como Jekyll, Hugo e Astro usam arquivos Markdown como fonte de conteudo. Documentacao tecnica, blogs, wikis, bases de conhecimento internas -- Markdown se tornou o formato de escrita padrao no mundo tech. Vale a pena aprender mesmo que voce nao seja desenvolvedor.

Escrever bom Markdown: o que quase todo mundo erra

Nao pule niveis de titulo -- ir de # direto para ### quebra a estrutura do documento e confunde leitores de tela. Sempre coloque uma linha em branco entre paragrafos (Markdown ignora quebras de linha simples). Nos blocos de codigo, especifique a linguagem (por exemplo ```javascript) para ativar o realce de sintaxe. Para documentos longos, adicione um sumario -- seus leitores vao agradecer. E sempre visualize antes de publicar, porque o Markdown pode renderizar com pequenas diferencas dependendo da plataforma.