Хостинг изображений для GitHub README

Изображения README загружаются лучше всего с надежных HTTPS URL. Загружайте ваш ресурс, копируйте прямую ссылку и ссылайтесь на нее в Markdown, чтобы участники видели диаграммы и скриншоты в представлении репозитория.

GitHub отображает изображения README из абсолютных URL. Загружайте PNG или WebP для UI-скриншотов; SVG может оставаться в репозитории, когда это разрешено политикой, в противном случае растрируйте с помощью нашего инструмента SVG→PNG.

Держите файлы маленькими: сжимайте перед хостингом, чтобы клоны и мобильные зрители оставались быстрыми.

Для больших диаграмм рассмотрите возможность разделения на несколько изображений или ссылки на документацию.

Используйте значимые имена файлов перед загрузкой, чтобы текст альтернативы оставался ясным.

Если ссылка перестает работать после истечения срока, обновите изображение, повторно загрузив его с более длительным сроком хранения для долгоживущих проектов.

Сочетайте с нашим руководством по Stack Overflow при кросс-постинге проблем с документацией.

Related tools & pages

Upload an image now

FAQ

Зафиксированные ресурсы используют сырые URL; внешние хосты работают, когда вы не хотите, чтобы бинарные файлы были в истории git — выбирайте в зависимости от политики репозитория и размера.

PNG для четкого интерфейса, WebP, когда вам нужны меньшие размеры и поддержка со стороны зрителей, JPEG для фотографий.

Да — разработчики могут интегрироваться через наш REST API для повторяемых конвейеров документации.

Зависит от выбранного срока хранения при загрузке; выберите более длительный срок хранения для постоянных значков и баннеров README.