## سير المطورين
كيف تعاين GitHub README.md محليا على Mac
نشر مارس 2026
عدّلت README وتريد أن ترى كيف يبدو قبل الرفع. هنا ثلاث طرق، من الثقيلة إلى الفورية.
## لماذا المعاينة المحلية؟
لماذا أعاين محليا؟
- تحقق قبل الرفع. الجداول المكسورة والروابط الخاطئة وكتل الكود المشوهة محرجة في المستودع العام.
- العمل دون اتصال. لا ينبغي أن يحتاج README إلى الإنترنت لكي تراجعه.
- مراجعة تغييرات التوثيق في PR. عندما يغيّر طلب سحب README، تريد رؤية الناتج المعروض مع فرق الكود.
- تجنب دورة الرفع/التحقق. الرفع فقط لمعرفة شكل العرض يضيع الوقت ويشوّه السجل.
## الطريقة الأولى
grip (أداة CLI)
pip install grip grip README.md
يعرض grip Markdown باستخدام GitHub API، لذا تحصل على عرض مطابق تقريبا لعرض GitHub في المتصفح.
الإيجابيات
- عرض مطابق تقريبا لـ GitHub
السلبيات
- يتطلب Python
- يحتاج أحيانا إلى GitHub API token
- يعمل كخادم محلي يجب تشغيله وإيقافه
## الطريقة الثانية
معاينة VS Code المدمجة
Open README.md in VS Code Cmd + Shift + V → preview pane
لدى VS Code معاينة Markdown مدمجة. افتح الملف ثم استخدم الاختصار لعرض الناتج المعروض.
الإيجابيات
- مثبت عند أغلب المطورين
- يعمل دون اتصال
السلبيات
- تشغيل IDE كاملة فقط لمعاينة README أمر ثقيل
- العرض لا يطابق GitHub تماما
- مرتبط بالمحرر نفسه
## الطريقة الثالثة (الموصى بها)
ShowMeMyMD - فقط انقر مرتين
git clone <repo> Double-click README.md Done.
ShowMeMyMD عارض Markdown أصلي لـ macOS. اجعله التطبيق الافتراضي لملفات .md، وسيُعرض كل README فورا.
يدعم جداول GitHub، وقوائم المهام، وكتل الكود، وتنبيهات GitHub.
انسخ README وافتحه، وانتهى الأمر.
## مقارنة
مقارنة جنباً إلى جنب
| الأداة | الإعداد | الدقة | السرعة | دون اتصال |
|---|---|---|---|---|
| grip | Python + pip install | مطابقة تقريبا | أبطأ | لا |
| VS Code | مثبت مسبقا | جزئية | سريع | نعم |
| ShowMeMyMD | تثبيت مرة واحدة | GFM كامل + callouts | فوري | نعم |
## اقرأ المزيد
تعرف أكثر على ShowMeMyMD كعارض Markdown على Mac. واطلع على سير العمل للمطورين.
توقف عن الرفع فقط لتفقد README
انقر مرتين على أي ملف .md وشاهده فورا بتنسيق GitHub Flavored Markdown.
حمّل منMac App Store