Фотохостинг для Markdown: зображення для GitHub README, документації та нотаток

Автор: команда продукту

Завантажте скриншот, діаграму або GIF. Ви отримаєте код Markdown, готовий до вставлення в README, вікі чи нотатки - безкоштовно, без реєстрації, а посилання не спливає.

Завантажити зображення

★ Оцінка 4.7/5 на основі оцінок користувачів: 326

Markdown показує зображення за посиланням: ![alt text](image link). Зображення має десь зберігатися в інтернеті. YourImageShare безкоштовно розмістить його й видасть готовий рядок Markdown для GitHub, GitLab, Obsidian, сайтів із документацією чи будь-якого іншого файлу Markdown.

Отримайте Markdown для зображення

  1. Завантажте зображення. Натисніть Завантажити зображення або на комп'ютері вставте скриншот прямо з буфера обміну через Ctrl+V.
  2. Відкрийте вкладку Markdown, коли завантаження завершиться, і скопіюйте код.
  3. Вставте його у свій файл.

Вкладка Markdown дає зображення-посилання, яке відкриває картинку в повному розмірі:

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

Щоб отримати звичайне зображення без посилання, залиште лише внутрішню частину й додайте змістовний альтернативний текст:

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

Зображення в GitHub README, issues і вікі

GitHub показує зовнішні зображення в README, issues, pull request, обговореннях і вікі. Вставте код Markdown, і зображення з'явиться, коли сторінку буде відображено.

  • Задайте розмір за допомогою HTML-тега, який GitHub дозволяє в Markdown: <img src="https://yourimageshare.com/ib/AbC123xYz0.png" width="400" alt="Screenshot">
  • Демо-GIF програються просто в README - див. хостинг GIF, або перетворіть запис екрана на GIF у конвертері відео в GIF.
  • Альтернативний текст описує зображення для програм зчитування з екрана й показується, якщо зображення не вдалося завантажити.

Obsidian, Notion і сайти з документацією

  • Obsidian, Typora, перегляд у VS Code та інші редактори Markdown показують зображення за посиланням, тож ваші нотатки залишаються невеликими, а зображення працює на кожному пристрої.
  • Notion: введіть /image, виберіть Embed link і вставте пряме посилання (вкладка Direct).
  • Сайти з документацією на MkDocs, Docusaurus, Jekyll, Hugo чи GitBook відображають такий самий синтаксис зображень Markdown.

Навіщо тримати зображення поза репозиторієм

  • Менші репозиторії. Скриншоти та GIF додають мегабайти до кожного клону назавжди, навіть після того, як ви їх замінили. Зображення на хостингу завантажується лише тоді, коли хтось відкриває сторінку.
  • Посилання не спливають. Зображення зберігаються, доки ви їх не видалите.
  • Реєстрація не потрібна, і нічого налаштовувати не треба. Для скриптів і CI є безкоштовний API для завантаження.
  • Повна роздільна здатність і без водяного знака. Дані EXIF, зокрема геолокація, видаляються перед збереженням зображення.

Поширені запитання

Як додати зображення у файл Markdown?
Завантажте зображення, скопіюйте код на вкладці Markdown і вставте його у файл. Markdown показує зображення за допомогою ![alt text](image link).
Чи можна використовувати ці зображення в GitHub README?
Так. GitHub показує зовнішні зображення в README, issues, pull request і вікі. Вставте код Markdown, і зображення з'явиться, коли файл буде відображено.
Як задати розмір зображення в README?
У звичайному Markdown немає параметра розміру. На GitHub використовуйте HTML-тег зображення з шириною, наприклад <img src="image link" width="400" alt="Screenshot">.
Навіщо розміщувати зображення для README поза репозиторієм?
Скриншоти та демо-GIF додають мегабайти до кожного клону репозиторію. Зображення на хостингу завантажується лише тоді, коли хтось переглядає README.
Чи спливає термін дії посилань на зображення?
Ні. Зображення зберігаються, доки ви їх не видалите, тож посилання в документації продовжують працювати.

Готові додати своє зображення?