Lição 5
Visualização e exportação HTML
Entenda visualização ao vivo, fragmentos HTML sanitizados e quando copiar Markdown vs HTML.
Ferramentas de Markdown costumam oferecer duas saídas diferentes:
- Prévia renderizada para ler enquanto escreve
- Exportação HTML para sistemas que precisam de fragmentos HTML
Estão relacionadas, mas não são idênticas.
O que a prévia ao vivo mostra
A prévia parseia Markdown e renderiza conteúdo estruturado como títulos, parágrafos, listas e tabelas. Em ferramentas no navegador, isso em geral significa elementos HTML estilizados com CSS.
A prévia responde: “Este documento lê bem?”
O que a exportação HTML fornece
Exportação HTML converte Markdown em tags como:
<h1>Título</h1>
<p>Texto do parágrafo.</p>
<ul>
<li>Item</li>
</ul>
Boas ferramentas sanitizam o HTML e evitam promover blocos HTML brutos a conteúdo ativo.
Exportação HTML responde: “Qual fragmento posso colar em outro sistema?”
Quando copiar Markdown vs HTML
| Destino | Melhor escolha |
|---|---|
| README ou issue no GitHub | Fonte Markdown |
Repositório de docs com .md | Fonte Markdown |
| Campo rich-text de CMS | Fragmento HTML |
| E-mail ou wiki interna | Fragmento HTML, muitas vezes com revisão |
| Discussão em code review | Fonte Markdown |
A maioria dos pipelines de publicação prefere Markdown porque o destino aplica seu próprio tema.
Tema de prévia vs exportação
Estilo de prévia ajuda a escrever com conforto, mas HTML copiado em geral não inclui o CSS do tema de prévia, salvo se a ferramenta exportar HTML estilizado explicitamente. Isso é normal.
Conclusão
Use prévia para validar estrutura e legibilidade. Use exportação HTML quando o próximo sistema precisa de HTML semântico, não de fonte Markdown.
A ferramenta Visualizar Markdown / Markdown para HTML suporta os dois caminhos: prévia ao vivo mais copiar/baixar fragmentos HTML sanitizados.