Alojamento de Imagens para Markdown: Imagens para READMEs do GitHub, Documentação e Notas

Por Equipa do Produto

Carregue uma captura de ecrã, um diagrama ou um GIF. Recebe Markdown pronto a colar num README, numa wiki ou nas suas notas - grátis, sem registo, e o link não expira.

Carregar uma imagem

★ Avaliação de 4.4/5 com base em 137 avaliações de utilizadores

O Markdown mostra uma imagem a partir de um link: ![alt text](image link). A imagem tem de estar algures na Web. O YourImageShare aloja-a gratuitamente e dá-lhe a linha de Markdown pronta a colar, para GitHub, GitLab, Obsidian, sites de documentação ou qualquer outro ficheiro Markdown.

Obter o Markdown de uma imagem

  1. Carregue a imagem. Prima Carregar uma imagem ou, no computador, cole uma captura de ecrã diretamente da área de transferência com Ctrl+V.
  2. Abra o separador Markdown quando o carregamento terminar e copie o código.
  3. Cole-o no seu ficheiro.

O separador Markdown dá uma imagem clicável que abre a imagem em tamanho real:

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

Para uma imagem simples, sem o link, mantenha apenas a parte interior e escreva um texto alternativo descritivo:

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

Imagens em READMEs, issues e wikis do GitHub

O GitHub mostra imagens externas em READMEs, issues, pull requests, discussões e wikis. Cole o código Markdown e a imagem aparece quando a página for processada.

  • Defina um tamanho com uma etiqueta HTML, que o GitHub permite em Markdown: <img src="https://yourimageshare.com/ib/AbC123xYz0.png" width="400" alt="Screenshot">
  • Os GIF de demonstração continuam a reproduzir-se num README - veja o alojamento de GIF, ou transforme uma gravação de ecrã num GIF com o conversor de vídeo para GIF.
  • O texto alternativo descreve a imagem para leitores de ecrã e aparece se a imagem não carregar.

Obsidian, Notion e sites de documentação

  • Obsidian, Typora, pré-visualização do VS Code e outros editores de Markdown mostram a imagem a partir do link, por isso as suas notas ficam pequenas e a imagem funciona em todos os dispositivos.
  • Notion: escreva /image, escolha Embed link e cole o link direto (o separador Direct).
  • Os sites de documentação criados com MkDocs, Docusaurus, Jekyll, Hugo ou GitBook processam a mesma sintaxe de imagem Markdown.

Porquê alojar imagens fora do repositório

  • Repositórios mais pequenos. As capturas de ecrã e os GIF acrescentam megabytes a cada clone, para sempre, mesmo depois de os substituir. Uma imagem alojada só é carregada quando alguém vê a página.
  • Os links não expiram. As imagens são mantidas até as eliminar.
  • Sem necessidade de conta e nada para configurar. Para scripts e CI, existe uma API de carregamento grátis.
  • Resolução total e sem marca de água. Os dados EXIF, incluindo a localização, são removidos antes de a imagem ser guardada.

Perguntas frequentes

Como adiciono uma imagem a um ficheiro Markdown?
Carregue a imagem, copie o código Markdown do separador Markdown e cole-o no ficheiro. O Markdown mostra uma imagem com ![alt text](image link).
Posso usar estas imagens num README do GitHub?
Sim. O GitHub mostra imagens externas em READMEs, issues, pull requests e wikis. Cole o código Markdown e a imagem aparece quando o ficheiro for processado.
Como defino o tamanho de uma imagem num README?
O Markdown simples não tem opção de tamanho. No GitHub, use uma etiqueta de imagem HTML com largura, por exemplo <img src="image link" width="400" alt="Screenshot">.
Porquê alojar as imagens do README fora do repositório?
As capturas de ecrã e os GIF de demonstração acrescentam megabytes a cada clone do repositório. Uma imagem alojada só é carregada quando alguém vê o README.
Os links das imagens expiram?
Não. As imagens são mantidas até as eliminar, por isso os links na documentação continuam a funcionar.

Mais casos de utilização

Pronto para adicionar a sua imagem?