Hospedagem de Imagens para Markdown: Imagens para README do GitHub, Docs e Notas

Por Equipe de Produto

Envie uma captura de tela, diagrama ou GIF. Você recebe o Markdown pronto para colar em um README, uma wiki ou nas suas notas - grátis, sem cadastro, e o link não expira.

Enviar imagem

★ Nota 4.4/5 com base em 137 avaliações de usuários

O Markdown mostra uma imagem a partir de um link: ![alt text](image link). A imagem precisa estar em algum lugar da web. O YourImageShare faz a hospedagem de imagens grátis e entrega a linha de Markdown pronta para colar, no GitHub, GitLab, Obsidian, sites de documentação ou qualquer outro arquivo Markdown.

Obtenha o Markdown de uma imagem

  1. Envie a imagem. Clique em Enviar imagem ou, no computador, cole uma captura de tela direto da área de transferência com Ctrl+V.
  2. Abra a aba Markdown quando o upload terminar e copie o código.
  3. Cole no seu arquivo.

A aba Markdown fornece uma imagem clicável que abre a versão em tamanho original:

[![AbC123xYz0](https://yourimageshare.com/ib/AbC123xYz0.png)](https://yourimageshare.com/ib/AbC123xYz0)

Para uma imagem simples, sem o link, mantenha só a parte interna e escreva um texto alternativo de verdade:

![Settings screen](https://yourimageshare.com/ib/AbC123xYz0.png)

Imagens em READMEs, issues e wikis do GitHub

O GitHub exibe imagens externas em READMEs, issues, pull requests, discussions e wikis. Cole o código Markdown e a imagem aparece quando a página é renderizada.

  • Defina um tamanho com uma tag HTML, que o GitHub permite no Markdown: <img src="https://yourimageshare.com/ib/AbC123xYz0.png" width="400" alt="Screenshot">
  • GIFs de demonstração continuam animados em um README - veja a hospedagem de GIF, ou transforme uma gravação de tela em GIF com o conversor de vídeo para GIF.
  • O texto alternativo descreve a imagem para leitores de tela e aparece caso ela não carregue.

Obsidian, Notion e sites de documentação

  • Obsidian, Typora, a prévia do VS Code e outros editores Markdown mostram a imagem a partir do link, então suas notas ficam leves e a imagem funciona em qualquer dispositivo.
  • Notion: digite /image, escolha Embed link e cole o link direto (a aba Direto).
  • Sites de documentação feitos com MkDocs, Docusaurus, Jekyll, Hugo ou GitBook renderizam a mesma sintaxe de imagem em Markdown.

Por que hospedar imagens fora do repositório

  • Repositórios menores. Capturas de tela e GIFs adicionam megabytes a cada clone, para sempre, mesmo depois de você substituí-los. Uma imagem hospedada só é carregada quando alguém vê a página.
  • Os links não expiram. As imagens ficam guardadas até você excluí-las.
  • Sem cadastro e nada para configurar. Para scripts e CI, há uma API de upload grátis.
  • Resolução original e sem marca d'água. Os dados EXIF, incluindo a localização, são removidos antes de a imagem ser armazenada.

Perguntas frequentes

Como adicionar uma imagem a um arquivo Markdown?
Envie a imagem, copie o código da aba Markdown e cole no arquivo. O Markdown mostra uma imagem com ![alt text](image link).
Posso usar essas imagens em um README do GitHub?
Sim. O GitHub exibe imagens externas em READMEs, issues, pull requests e wikis. Cole o código Markdown e a imagem aparece quando o arquivo é renderizado.
Como definir o tamanho de uma imagem em um README?
O Markdown puro não tem opção de tamanho. No GitHub, use uma tag HTML de imagem com largura, por exemplo <img src="image link" width="400" alt="Screenshot">.
Por que hospedar imagens do README fora do repositório?
Capturas de tela e GIFs de demonstração adicionam megabytes a cada clone do repositório. Uma imagem hospedada só é carregada quando alguém vê o README.
Os links das imagens expiram?
Não. As imagens ficam guardadas até você excluí-las, então os links na documentação continuam funcionando.

Mais casos de uso

Pronto para adicionar sua imagem?