Usar imagens em Markdown com contexto
Escolha fontes fiáveis, escreva descrições úteis e verifique a imagem exportada antes de partilhar o seu Markdown.
Uma imagem em Markdown precisa de mais do que uma ligação válida. O leitor deve perceber o que mostra, porque está ali e onde encontrar a fonte editável. Use o conversor de Markdown para verificar toda a composição antes de a partilhar como imagem.
Uma ilustração deve explicar um ponto realmente abordado no texto. Uma lista de verificação de lançamento pode mostrar uma revisão pendente; uma fotografia decorativa de um portátil não comunica esse estado. Coloque a explicação junto da imagem para o leitor não ter de adivinhar o seu significado.
Na sintaxe de imagens do Markdown, a descrição fica entre parênteses retos e a fonte entre parênteses curvos. A especificação CommonMark documenta esta estrutura. Uma descrição útil identifica o que interessa naquele contexto, em vez de repetir um nome de ficheiro ou dizer apenas «imagem».
Esta demonstração usa uma imagem de lista de verificação fornecida. Mantenha a descrição e a frase inferior juntas: a primeira descreve o elemento visual e a segunda explica que a fonte continua editável.
# Image with useful context
The source document remains editable; the exported card is for sharing.
O resultado combina imagem e texto para uma atualização de revisão interna. Não é uma cópia editável da lista original. Se o item pendente for essencial à mensagem, mencione-o também no texto que acompanha a publicação.
Abra primeiro o URL da imagem diretamente e confirme que apresenta a imagem pretendida. Um endereço copiado pode levar a uma página de partilha, a uma ligação expirada ou a um ficheiro que exige a sua sessão iniciada. Um caminho relativo válido num repositório pode não fazer sentido num editor Web separado.
Use uma fonte que controla e tem autorização para partilhar. Não torne pública uma captura privada apenas para resolver o carregamento: oculte os dados sensíveis ou escolha uma imagem de demonstração segura. Depois de substituir o URL, confirme o acesso e verifique a pré-visualização antes de exportar.
As pequenas legendas de uma captura larga podem continuar ilegíveis mesmo com um cartão bem organizado. Recorte as zonas da interface que não interessam e mantenha a parte que explica o assunto. Evite ampliar uma fonte minúscula: aumentar as dimensões de exportação não recupera pormenores ausentes do original.
No ficheiro descarregado, inspecione a imagem incorporada e o texto envolvente no tamanho em que serão apresentados. Acrescente uma explicação textual acessível à publicação: as descrições na fonte Markdown não substituem o texto alternativo da imagem exportada.
Pré-visualize o Markdown com imagens antes de publicar.
Guias relacionados: colocar duas imagens lado a lado e exportar Markdown como PNG.