Hosting zdjęć do Markdown: obrazki do README na GitHubie, dokumentacji i notatek

Autor: Product Team

Wrzuć zrzut ekranu, diagram lub GIF. Dostaniesz gotowy kod Markdown do wklejenia w README, wiki lub notatkach - darmowo, bez rejestracji, a link nie wygasa.

Prześlij zdjęcie

★ Ocena 4.7/5 na podstawie 326 ocen użytkowników

Markdown wyświetla obraz na podstawie linku: ![alt text](image link). Zdjęcie musi być gdzieś w sieci. YourImageShare hostuje je za darmo i daje ci gotową linijkę Markdown do wklejenia, na GitHubie, w GitLabie, Obsidianie, dokumentacji lub dowolnym innym pliku Markdown.

Kod Markdown dla zdjęcia

  1. Wrzuć zdjęcie. Naciśnij Prześlij zdjęcie lub na komputerze wklej zrzut ekranu prosto ze schowka za pomocą Ctrl+V.
  2. Otwórz zakładkę Markdown po zakończeniu przesyłania i skopiuj kod.
  3. Wklej go do swojego pliku.

Zakładka Markdown daje klikalny obraz, który otwiera zdjęcie w pełnym rozmiarze:

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

Jeśli chcesz zwykły obraz bez linku, zostaw tylko wewnętrzną część i dodaj prawdziwy tekst alternatywny:

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

Zdjęcia w README, issue i wiki na GitHubie

GitHub wyświetla zewnętrzne obrazy w plikach README, issue, pull requestach, dyskusjach i wiki. Wklej kod Markdown, a zdjęcie pojawi się po wyrenderowaniu strony.

  • Ustaw rozmiar za pomocą znacznika HTML, który GitHub dopuszcza w Markdown: <img src="https://yourimageshare.com/ib/AbC123xYz0.png" width="400" alt="Screenshot">
  • Animowane GIF-y działają w README - zobacz hosting GIF albo zamień nagranie ekranu na GIF za pomocą konwertera wideo na GIF.
  • Tekst alternatywny opisuje obraz czytnikom ekranu i wyświetla się, gdy obraz się nie załaduje.

Obsidian, Notion i strony z dokumentacją

  • Obsidian, Typora, podgląd w VS Code i inne edytory Markdown pokazują obraz z linku, więc notatki zostają małe, a zdjęcie działa na każdym urządzeniu.
  • Notion: wpisz /image, wybierz Embed link i wklej bezpośredni link (zakładka Direct).
  • Strony z dokumentacją zbudowane w MkDocs, Docusaurus, Jekyll, Hugo lub GitBook obsługują ten sam zapis obrazów w Markdown.

Dlaczego hostować zdjęcia poza repozytorium

  • Mniejsze repozytoria. Zrzuty ekranu i GIF-y dodają megabajty do każdego klonu, na zawsze, nawet po ich zastąpieniu. Zdjęcie na hostingu ładuje się dopiero wtedy, gdy ktoś ogląda stronę.
  • Linki nie wygasają. Zdjęcia są przechowywane, dopóki ich nie usuniesz.
  • Bez rejestracji i bez konfiguracji. Do skryptów i CI jest darmowe API do przesyłania.
  • Pełna rozdzielczość i bez znaku wodnego. Dane EXIF, w tym lokalizacja, są usuwane przed zapisaniem zdjęcia.

Najczęstsze pytania

Jak dodać zdjęcie do pliku Markdown?
Prześlij zdjęcie, skopiuj kod z zakładki Markdown i wklej go do pliku. Markdown wyświetla obraz za pomocą zapisu ![alt text](image link).
Czy mogę używać tych zdjęć w README na GitHubie?
Tak. GitHub wyświetla zewnętrzne obrazy w plikach README, issue, pull requestach i wiki. Wklej kod Markdown, a zdjęcie pojawi się po wyrenderowaniu pliku.
Jak ustawić rozmiar zdjęcia w README?
Zwykły Markdown nie ma opcji rozmiaru. Na GitHubie użyj znacznika HTML z szerokością, na przykład <img src="image link" width="400" alt="Screenshot">.
Po co trzymać zdjęcia do README poza repozytorium?
Zrzuty ekranu i animowane GIF-y dodają megabajty do każdego klonu repozytorium. Zdjęcie na hostingu ładuje się dopiero wtedy, gdy ktoś ogląda README.
Czy linki do zdjęć wygasają?
Nie. Zdjęcia są przechowywane, dopóki ich nie usuniesz, więc linki w dokumentacji nadal działają.

Gotowy, żeby dodać zdjęcie?