Como faço para adicionar uma legenda de imagem em Markdown?

2023-12-18

Adicionar legendas a imagens em Markdown pode aprimorar a compreensão e o contexto da imagem. Embora o Markdown padrão não suporte diretamente legendas para imagens, existem maneiras de incluí-las.

Usando Texto Alternativo como Legenda

O método mais simples é usar o texto alternativo da imagem como uma legenda:

![Esta é a legenda da imagem](image-url.jpg)

Isso será renderizado como uma imagem com o texto alternativo, que pode atuar como uma legenda.

Método HTML

Para uma legenda mais explícita, você pode usar tags HTML:

<figure>
    <img src="image-url.jpg" alt="Texto alternativo" />
    <figcaption>Esta é a legenda da imagem</figcaption>
</figure>

Este método renderiza uma imagem com uma legenda abaixo dela. A tag <figure> é um elemento HTML semântico usado para representar conteúdo autônomo, muitas vezes com uma legenda (<figcaption>), e é bem adequado para imagens.

Renderizadores Markdown com Suporte a Legendas

Alguns renderizadores ou extensões de Markdown suportam sintaxe para legendas de imagens. Por exemplo, o Pandoc possui uma sintaxe para figuras com legendas. Verifique se seu ambiente Markdown possui tais recursos.

Lembre-se, a aparência das legendas pode variar dependendo do renderizador de Markdown ou da plataforma que você está usando, por isso é importante testar como seu documento é renderizado no ambiente pretendido.