Boas práticas para imagens em Markdown

Este guia cobre imagens em Markdown e mostra como manter imagens acessíveis e confiáveis em repositórios, documentação e exportações. O objetivo não é uma captura qualquer, mas um recurso legível, ligado à fonte Markdown e reutilizável na publicação.

PNG mantém texto, código, tabelas e linhas finas nítidos. JPEG pode ser menor com fundos fotográficos, mas suaviza letras pequenas. PDF serve leitura em várias páginas e DOCX edição de escritório. Escolha conforme o canal final.

1. Preparar. escrever texto alternativo que explique a informação.
2. Pré-visualizar. usar URLs HTTPS estáveis ou caminhos resolvíveis pelo renderizador.
3. Exportar. testar referências, títulos, dimensões e contraste escuro no destino.

Cole este exemplo curto para validar tipografia e espaço antes do conteúdo real.

![Dashboard showing weekly signups](https://example.com/dashboard.png "Weekly signup dashboard")

![Architecture diagram][architecture]

[architecture]: https://example.com/architecture.svg "Service architecture"

CommonMark define o núcleo portátil. Tabelas, tarefas e alguns autolinks são extensões GFM e podem variar. Mermaid e KaTeX são sintaxes separadas que exigem renderizadores compatíveis. Teste sempre no destino final.

• Escreva alt útil para imagens informativas.
• Mantenha hierarquia e leitura lógicas.
• Confira contraste claro e escuro.
• Revise no tamanho real de publicação.
• Versione a fonte Markdown.
• Reexporte após mudanças; não remende texto no bitmap.

Evite letras mínimas, tabelas largas, siglas sem explicação, imagens remotas instáveis e recortes sem contexto. Não prometa render idêntico em todos os motores: extensões e temas limitam a portabilidade.

Os limites factuais foram verificados nestas fontes primárias:

• https://spec.commonmark.org/current/
• https://docs.github.com/en/get-started/writing-on-github
• https://markdowntoimage.com/

Abra MarkdownToImage e teste o exemplo com largura e tema finais. Continue no primeiro guia e no segundo guia.