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

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

Загрузите скриншот, схему или GIF. Вы получите Markdown, готовый для вставки в README, вики или заметки: бесплатно, без регистрации, а ссылка не истекает.

Загрузить изображение

★ Оценка 4.4/5 на основе 137 оценок пользователей

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, issue и вики

GitHub показывает внешние изображения в README, issue, 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, issue, pull request и вики. Вставьте код Markdown, и изображение появится, когда файл будет отображён.
Как задать размер изображения в README?
В обычном Markdown нет параметра размера. На GitHub используйте HTML-тег изображения с шириной, например <img src="image link" width="400" alt="Screenshot">.
Зачем хранить изображения для README вне репозитория?
Скриншоты и демо-GIF добавляют мегабайты к каждому клону репозитория. Изображение на хостинге загружается, только когда кто-то открывает README.
Ссылки на изображения истекают?
Нет. Изображения хранятся, пока вы их не удалите, поэтому ссылки в документации продолжают работать.

Другие сценарии использования

Готовы добавить своё изображение?