Hosting Gambar Markdown: Gambar untuk README GitHub, Dokumentasi, dan Catatan

Oleh Tim Produk

Unggah screenshot, diagram, atau GIF. Anda mendapat kode Markdown siap tempel ke README, wiki, atau catatan Anda - gratis, tanpa daftar, dan link tidak kedaluwarsa.

Unggah Gambar

★ Rating 4.4/5 dari 137 penilaian pengguna

Markdown menampilkan gambar dari sebuah link: ![alt text](image link). Gambar harus tersimpan di suatu tempat di web. YourImageShare menghostingnya secara gratis dan memberi Anda baris Markdown siap tempel, untuk GitHub, GitLab, Obsidian, situs dokumentasi, atau file Markdown lainnya.

Dapatkan Markdown untuk Gambar

  1. Unggah gambar. Tekan Unggah Gambar, atau di komputer tempel screenshot langsung dari clipboard dengan Ctrl+V.
  2. Buka tab Markdown setelah unggahan selesai, lalu salin kodenya.
  3. Tempel ke file Anda.

Tab Markdown memberikan gambar yang bisa diklik dan membuka gambar ukuran penuh:

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

Untuk gambar biasa tanpa link, ambil bagian dalamnya saja dan beri teks alt yang jelas:

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

Gambar di README, Issue, dan Wiki GitHub

GitHub menampilkan gambar eksternal di README, issue, pull request, diskusi, dan wiki. Tempel kode Markdown, dan gambar akan muncul saat halaman ditampilkan.

  • Atur ukuran dengan tag HTML, yang diizinkan GitHub di dalam Markdown: <img src="https://yourimageshare.com/ib/AbC123xYz0.png" width="400" alt="Screenshot">
  • GIF demo tetap berputar di README - lihat hosting GIF, atau ubah rekaman layar menjadi GIF dengan konverter video ke GIF.
  • Teks alt menjelaskan gambar untuk pembaca layar dan tampil jika gambar gagal dimuat.

Obsidian, Notion, dan Situs Dokumentasi

  • Obsidian, Typora, pratinjau VS Code dan editor Markdown lainnya menampilkan gambar dari link, sehingga catatan Anda tetap kecil dan gambar tampil di semua perangkat.
  • Notion: ketik /image, pilih Embed link lalu tempel link langsung (tab Direct).
  • Situs dokumentasi yang dibuat dengan MkDocs, Docusaurus, Jekyll, Hugo, atau GitBook menampilkan sintaks gambar Markdown yang sama.

Mengapa Hosting Gambar di Luar Repositori

  • Repositori lebih kecil. Screenshot dan GIF menambah beberapa megabyte pada setiap clone, selamanya, bahkan setelah Anda menggantinya. Gambar yang dihosting hanya dimuat saat seseorang membuka halaman.
  • Link tidak kedaluwarsa. Gambar disimpan sampai Anda menghapusnya.
  • Tanpa daftar dan tanpa pengaturan apa pun. Untuk skrip dan CI, tersedia API unggah gratis.
  • Resolusi penuh dan tanpa watermark. Data EXIF, termasuk lokasi, dihapus sebelum gambar disimpan.

Pertanyaan yang Sering Diajukan

Bagaimana cara menambahkan gambar ke file Markdown?
Unggah gambar, salin kode Markdown dari tab Markdown, lalu tempel ke file Anda. Markdown menampilkan gambar dengan ![alt text](image link).
Bisakah gambar ini dipakai di README GitHub?
Bisa. GitHub menampilkan gambar eksternal di README, issue, pull request, dan wiki. Tempel kode Markdown, dan gambar akan muncul saat file ditampilkan.
Bagaimana cara mengatur ukuran gambar di README?
Markdown biasa tidak punya opsi ukuran. Di GitHub, gunakan tag gambar HTML dengan atribut width, misalnya <img src="image link" width="400" alt="Screenshot">.
Mengapa gambar README sebaiknya dihosting di luar repositori?
Screenshot dan GIF demo menambah beberapa megabyte pada setiap clone repositori. Gambar yang dihosting hanya dimuat saat seseorang membuka README.
Apakah link gambar kedaluwarsa?
Tidak. Gambar disimpan sampai Anda menghapusnya, sehingga link di dokumentasi tetap berfungsi.

Kasus Penggunaan Lainnya

Siap Menambahkan Gambar Anda?