آپلود عکس برای Markdown: تصویر برای README گیت‌هاب، مستندات و یادداشت‌ها

توسط تیم محصول

اسکرین‌شات، نمودار یا GIF خود را آپلود کنید. کد Markdown آماده برای README، ویکی یا یادداشت‌هایتان را می‌گیرید؛ رایگان، بدون ثبت‌نام و با لینکی که منقضی نمی‌شود.

آپلود عکس

★ امتیاز 4.7 از 5 بر اساس 326 رأی کاربران

Markdown عکس را از روی یک لینک نمایش می‌دهد: ![alt text](image link). عکس باید جایی روی وب باشد. YourImageShare آن را رایگان نگه‌داری می‌کند و خط Markdown آماده‌ی چسباندن را به شما می‌دهد؛ برای گیت‌هاب، گیت‌لب، Obsidian، سایت‌های مستندات یا هر فایل Markdown دیگر.

گرفتن Markdown برای عکس

  1. عکس را آپلود کنید. روی آپلود عکس بزنید، یا در کامپیوتر با Ctrl+V اسکرین‌شات را مستقیم از کلیپ‌بورد بچسبانید.
  2. تب Markdown را باز کنید و بعد از پایان آپلود، کد را کپی کنید.
  3. آن را در فایل خود بچسبانید.

تب Markdown یک عکس قابل کلیک می‌دهد که تصویر با اندازه کامل را باز می‌کند:

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

برای عکس ساده بدون لینک، فقط بخش داخلی را نگه دارید و یک متن جایگزین (alt) مناسب بنویسید:

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

عکس در README، ایشو و ویکی گیت‌هاب

گیت‌هاب عکس‌های خارجی را در README، ایشوها، پول‌ریکوئست‌ها، دیسکاشن‌ها و ویکی‌ها نمایش می‌دهد. کد Markdown را بچسبانید تا هنگام نمایش صفحه، عکس ظاهر شود.

  • تعیین اندازه با تگ HTML، که گیت‌هاب در Markdown اجازه می‌دهد: <img src="https://yourimageshare.com/ib/AbC123xYz0.png" width="400" alt="Screenshot">
  • GIFهای نمایشی در README همچنان پخش می‌شوند؛ صفحه آپلود GIF را ببینید، یا با مبدل فیلم به GIF ضبط صفحه را به GIF تبدیل کنید.
  • متن جایگزین (alt) عکس را برای صفحه‌خوان‌ها توصیف می‌کند و اگر عکس بارگذاری نشود نمایش داده می‌شود.

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 کپی کنید و در فایل خود بچسبانید. Markdown عکس را با ![alt text](image link) نمایش می‌دهد.
آیا می‌توانم از این عکس‌ها در README گیت‌هاب استفاده کنم؟
بله. گیت‌هاب عکس‌های خارجی را در README، ایشوها، پول‌ریکوئست‌ها و ویکی‌ها نمایش می‌دهد. کد Markdown را بچسبانید تا هنگام نمایش فایل، عکس ظاهر شود.
اندازه عکس را در README چطور تنظیم کنم؟
Markdown ساده گزینه‌ای برای اندازه ندارد. در گیت‌هاب از تگ HTML تصویر با عرض مشخص استفاده کنید، مثلاً <img src="image link" width="400" alt="Screenshot">.
چرا عکس‌های README را بیرون از مخزن آپلود کنیم؟
اسکرین‌شات‌ها و GIFهای نمایشی چند مگابایت به هر کلون مخزن اضافه می‌کنند. عکسی که روی سرویس آپلود شده فقط وقتی کسی README را می‌بیند بارگذاری می‌شود.
آیا لینک عکس‌ها منقضی می‌شود؟
خیر. عکس‌ها تا وقتی خودتان حذفشان نکنید نگه‌داری می‌شوند، پس لینک‌ها در مستندات همیشه کار می‌کنند.

آماده‌اید عکس خود را اضافه کنید؟