Voltar ao Blog
domingo, 16 de novembro de 2025

Boas práticas para imagens em Markdown

Boas práticas para imagens em Markdown

Imagens fazem parte da narrativa

Markdown facilita inserir capturas, mas elas precisam de cuidado para sobreviver fora do repositório. Use uma rotina curta para manter padrão.

Comece pelo alt-text

  • Descreva o objetivo do gráfico.
  • Fique abaixo de 140 caracteres.
  • Cite números importantes para leitores em modo texto.

Hospede uma única vez

  1. Comprime com TinyPNG/ImageOptim ou exporte em 2×.
  2. Suba em Directus, S3 ou no CDN do Markdown2Image e registre a URL oficial.
  3. Controle arquivo, alt-text e data em planilha compartilhada.

Finalize no Markdown2Image

  1. Cole o snippet e escolha Thread, Deck ou Mobile.
  2. Ajuste tipografia, espaçamento e cores conforme o brand book.
  3. Exporte PNG/SVG/WebP e guarde o embed para README ou CMS.

Publicação

  • Poste o PNG nas redes com link para o conteúdo completo.
  • Use o SVG em apresentações para manter bordas limpas.
  • Inclua legenda curta em newsletters para situar o leitor.

Dessa forma você mantém desempenho, acessibilidade e consistência visual.

Boas práticas para imagens em Markdown | Markdown2Image | MarkdownToImage