برنامج حساب الوقت

يأخذ محول الماركداون إلى HTML سير العمل الأكثر شيوعًا للتأليف على الويب الحديث - الكتابة بـ Markdown، والنشر كـ HTML - ويجعله فوريًا. الصق أي ماركداون في الجزء الأيمن (أو الأيسر) وسيُظهر الجزء الآخر HTML المعروض في الوقت الفعلي. لا رحلات ذهاب وإياب للخادم، لا تسجيل، لا رفع ملفات: تعمل مكتبة marked.js بالكامل في متصفحك، محولة الماركداون إلى HTML نظيف في غضون مللي ثانية. استخدامه لتحويل README لمرة واحدة، معاينة مسودة المدونة، ترحيل CMS بين منصات ذات لهجات ماركداون مختلفة، أو التحقق السريع من صحة بناء الجملة قبل الالتزام بمولد مواقع ثابتة. يدعم مواصفات CommonMark الكاملة بالإضافة إلى امتدادات GitHub Flavored Markdown (الجداول، قوائم المهام، النص الذي يتوسطه خط، الروابط التلقائية) - مما يعني أن ما يعمل على GitHub سيعمل هنا بدون مفاجآت.

الخطوة 1: الصق نص الماركداون الخاص بك في جزء الإدخال الأيسر. يقبل المحول أي طول من سطر واحد إلى آلاف الأسطر من المحتوى. تعمل بناء جملة CommonMark القياسية: `#` للعناوين، `*text*` للميل، `text` للعريض، `` `code` `` للكود المضمن، `[link](url)` للروابط، `-` أو `*` لعناصر القوائم غير المرتبة، `1.` للقوائم المرتبة، `>` للاقتباسات، وثلاث علامات اقتباس عكسية لكتل الكود المحاطة. الخطوة 2: راقب الجزء الأيمن يعرض HTML في الوقت الفعلي أثناء الكتابة أو اللصق. تظهر الجداول بحدود مناسبة، وتحصل العناوين على سمات `id` منشأة تلقائياً (لروابط التثبيت)، وتحتفظ كتل الكود بعلامات اللغة، ويمر HTML المضمن. الخطوة 3: انقر فوق نسخ HTML للحصول على مصدر HTML الخام للصق في ملف `.html`، أو محرر نصوص منسقة في CMS، أو قالب موقع ثابت. انقر فوق نسخ المعروض لنسخ العرض المنسق إذا كانت وجهتك تدعم النص المنسق (Word، Google Docs، منسقو البريد الإلكتروني).

هذا المحول يمتلك الاثنين مفعلين افتراضياً. CommonMark (2014) هي مواصفات الماركداون القياسية غير الغامضة التي تحدد سلوك المحلل الدقيق - والتي اعتمدتها GitHub و Reddit و Stack Overflow و Discourse والمعظم من الأدوات الحديثة. توسع GitHub Flavored Markdown (GFM) مواصفات CommonMark بخمس اضافات: الجداول (صفوف مفصولة بالأنابيب مع المحاذاة)، قوائم المهام (`- [ ]` و `- [x]` للمربعات)، النص الذي يتوسطه خط (`~~text~~`)، الروابط التلقائية (تصبح الروابط الخام قابلة للنقر بدون بناء جملة `[](url)` صريح)، و HTML الخام المقيد (بعض العلامات تتم تصفيتها للأمان). نظراً لأن ملفات README الخاصة بـ GitHub هي مصدر الماركداون الأكثر شيوعاً على الويب، فإن توافق GFM ضروري - يعرض هذا المحول تماماً ما يعرضه GitHub لنفس المدخلات. إذا كنت بحاجة إلى إخراج CommonMark نقي (بدون امتدادات GFM)، يمكنك تعطيل GFM في قائمة الخيارات، لكن الإخراج الافتراضي يعمل مع 95% من حالات الاستخدام.

تستخدم جداول GFM أحرف الأنابيب (`|`) لتحديد الأعمدة والشرطات (`-`) في صف فاصل الرأس. بناء الجملة الأساسي: `| Name | Age |\n|------|-----|\n| Alice | 30 |`. يتم تشفير محاذاة الأعمدة في صف الفاصل: `-:` لليمين، `:-:` للمنتصف، `:-` أو `-` لليسار (افتراضي). مثال مع المحاذاة: `| Tool | Speed | Free |\n|:-----|------:|:----:|` ينتج جدولاً من 3 أعمدة مع Tool محاذاة لليسار، Speed محاذاة لليمين، Free محاذاة للمنتصف. يُخرج العارض عناصر `<table>` و `` و `` و `<tr>` و `<th>` و `<td>` المناسبة مع سمات `style="text-align:..."` المضمنة للمحاذاة. الأنابيب في بداية ونهاية كل صف اختيارية ولكنها تضاف عادة لتحسين القراءة. لا تحتاج عروض الأعمدة في المصدر إلى التوافق - فالمحلل لا يهتم بالتباعد البصري.

تستخدم كتل الكود المحاطة ثلاث علامات اقتباس عكسية (أو التلدة) للفتح والإغلاق: ```\ncode here\n```. أضف تلميحاً للغة بعد سياج الفتح تمكيناً لإبراز بناء الجملة عندما يتم نشر HTML: ```javascript أو ```python أو ```bash. يُخرج المحول `<pre><code class="language-X">` حيث X هو اسم اللغة. لا يقوم هذا المحول تطبيق ألوان بناء الجملة بنفسه - يتم التلوين بواسطة مكتبة منفصلة مثل highlight.js أو Prism.js أو Shiki عندما يتم عرض HTML على صفحتك. لماذا التقسيم؟ مكتبات إبراز بناء الجملة تتراوح كل منها بين 50 كيلوبايت و 200 كيلوبايت وتضيف وزناً كبيراً للصفحة؛ يبقى المحول خفيفاً عن طريق إخراج علامة اللغة فقط والسماح لخط أنابيب النشر الخاص بك بإضافة الألوان. علامات اللغات الشائعة: javascript، typescript، python، java، csharp، go، rust، ruby، php، html، css، json، yaml، xml، bash، sql، markdown.

واجهة الجزء المقسم - مصدر الماركداون على اليسار، معاينة HTML على اليمين - هي سير العمل القياسي للتأليف للكتاب التقنيين والمطورين. تتيح لك الكتابة بتنسيق الماركداون الخفيف والقابل للقراءة مع رؤية النتيجة ذات المظهر المنشور فوريًا. مقارنة بمحرري WYSIWYG (Word، Google Docs): الماركداون أسرع في الكتابة (لا حاجة للوصول بالماوس لأزرار التنسيق)، وقابل للتحكم في الإصدارات (فروق النصوص البسيطة تنظف نظيفاً في Git)، وقابل للنقل (أي محرر نصوص يعمل)، وينتج HTML نظيفاً بدون عناصر div متداخلة ضخمة. مقارنة بكتابة HTML مباشرة: الماركداون أسرع بـ 3-5 مرات للمحتوى النموذجي (العناوين، الفقرات، القوائم، الروابط)، ويقرأ بشكل طبيعي في شكله المصدري، ويزيل قرارات التنسيق من تدفق الكتابة. استخدم الماركداون لأي محتوى غني بالنصوص؛ وانتقل إلى HTML فقط عندما تحتاج إلى التحكم الدقيق في العرض.

يُخرج المحول HTML5 دلالي - عناصر تصف معنى المحتوى، وليس المظهر فقط. تصبح العناوين من `<h1>` إلى `<h6>` مع سمات `id` مُنشأة تلقائياً لربط التثبيت. تصبح الفقرات `<p>`. يصبح العريض `<strong>` (وليس `<b>`)، ويصبح المائل `<em>` (وليس `<i>`) - مكافئات دلالية تعمل بشكل أفضل مع قارئات الشاشة واستهداف CSS. تصبح القوائم غير المرتبة `<ul><li>`، والقوائم المرتبة `<ol><li>`. تصبح الاقتباسات `<blockquote>`. تصبح نطاقات الكود `<code>`، وتصبح الكتل المحاطة `<pre><code>`. تصبح الروابط `<a href>`. تصبح الصور `<img src alt>`. النتيجة هي HTML نظيف وقابل للوصول يتم إسقاطه في أي نظام إدارة محتوى حديث، أو مولد مواقع ثابتة، أو ملف HTML بدون تعديل. لا أنماط مضمنة (باستثناء محاذاة الجدول)، لا غلافات `<div>` إضافية، لا سمات فئة (باستثناء علامات اللغة على كتل الكود).

ملفات README هي مصدر الماركداون الأكثر شيوعاً على الويب - كل مستودع على GitHub يمتلك واحداً، ومعظم سجلات الحزم (npm، PyPI، RubyGems) تعرضها تلقائياً. لتحويل ملف README.md لموقع وثائق، الصق محتويات الملف في المحول وانسخ إخراج HTML. التعديلات الشائعة بعد التحويل: (1) الروابط النسبية - غالباً ما تستخدم ملفات README مسارات نسبية (`./docs/install.md`)؛ أعد كتابتها إلى روابط مطلوبة للموقع المنشور. (2) مسارات الصور - نفس المشكلة، صور README تستخدم `./images/logo.png`؛ قم بالتحديث إلى عنوان URL للصورة المنشورة. (3) معرفات التثبيت - معرفات العناوين المنشأة تلقائياً تستخدم تنسيق شرطات الأحرف الصغيرة (`Installation` تصبح `id="installation"`)؛ قم بتحديث روابط التثبيت الداخلية وفقاً لذلك. (4) بناء الجملة الخاص بالمستودع - يقوم GitHub بربط مراجع المشكلات تلقائياً مثل `#123` وإشارات المستخدمين مثل `@username`؛ هذه لا تربط تلقائياً خارج GitHub، أعد كتابتها كروابط صريحة إذا لزم الأمر.

تقوم مولدات المواقع الثابتة (SSGs) بمعالجة ملفات الماركداون إلى صفحات HTML في وقت البناء، لذلك لا يلزم عادةً التحويل اليدوي - أنت تلتزم بملفات `.md` في مستودعك ويتولى SSG الباقي. مولدات SSG الشائعة ومعالجتها للماركداون: Jekyll (Ruby) يستخدم kramdown افتراضياً، ومتوافق مع CommonMark مع بعض GFM. Hugo (Go) يستخدم Goldmark، ويدعم CommonMark الكامل + GFM + الامتدادات. Next.js MDX (JavaScript) يستخدم remark/rehype، ويتيح لك تضمين مكونات React في الماركداون. Eleventy (JavaScript) يستخدم markdown-it افتراضياً. Astro (JavaScript) يستخدم remark ويدعم MDX. Gatsby (JavaScript) يستخدم gatsby-plugin-mdx مع remark. هذا المحول هو الأكثر فائدة لـ: (a) التحويلات لمرة واحدة خارج سير عمل SSG، (b) التحقق من أن الماركداون الخاص بك يعرض بشكل صحيح قبل الالتزام، (c) ترحيل المحتوى بين SSGs التي تستخدم لهجات ماركداون مختلفة.

ستة أخطاء شائعة. (1) فواصل الأسطر اللينة داخل الفقرات - تندمج الأسطر الجديدة الفردية في مسافات وفقاً لـ CommonMark، وليس `<br>`. استخدم مسافتين لاحقتين أو سطر فارغ فاصل صريح. (2) كتل الكود المسافة البادئة (مسافة بادئة بـ 4 مسافات) مقابل المحاطة (ثلاثية الاقتباسات العكسية) - كلاهما يعمل، لكن المحاطة مستحسنة لأنها تحافظ على علامات اللغة. (3) القوائم المتداخلة بمسافة بادئة خاطئة - يتطلب CommonMark مسافتين أو 4 مسافات، خلط علامات التبويب والمسافات يكسر العرض على بعض المحللات. (4) HTML المضمن المزال بواسطة عارضين أكثر صرامة - تقوم GitHub و Reddit بتصفية العديد من العلامات للأمان؛ ما يعمل في هذا المحول قد لا يعمل في كل مكان. (5) العناوين بدون سطر فارغ قبلها/بعدها - تتسامح معظم المحللات، لكن CommonMark يوصي بأسطر فارغة للوضوح. (6) يتوسطه خط مع التلدة المفردة - التلدة المفردة لا تعمل، وتحتاج إلى `~~double tildes~~`. عند التصحيح، تحقق من اللهجة التي تتحدث بها المنصة المستهدفة (CommonMark؟ GFM؟ شيء مخصص؟) قبل افتراض أن المحول خطأ.

هذا المحول يعمل بنسبة 100% في متصفحك - نص Markdown الخاص بك لا يغادر الصفحة أبدًا. محولات Markdown التي تعمل من جهة الخادم تسجل عادةً كل عملية تحويل لأغراض التحليل وقد تخزن المدخلات للتخزين المؤقت أو مراقبة الأخطاء. بالنسبة لمعظم التحويلات العادية، لا يمثل هذا مشكلة، ولكن المطورين والكتاب التقنيين يلصقون بانتظام محتوى يجب ألا يتسرب: مفاتيح API في عينات الكود، والوثائق الداخلية، والمواصفات التقنية المملوكة، ومسودات منشورات المدونات الخاضعة لاتفاقية عدم الإفصاح، وبيانات العملاء في وثائق الدعم. التحويل من جهة العميل يقضي على مخاطر التسرب تمامًا. للتحقق: افتح علامة تبويب Network في أدوات المتصفح، والصق Markdown، وانقر فوق تحويل - ستري صفر طلبات خارجية أثناء التحويل. مكتبة marked.js يتم تحميلها مرة واحدة عند فتح الصفحة (ظاهرة في التحميل الأولي للصفحة)؛ بعد ذلك، يكون كل التحويل محليًا. بالنسبة لمدخلات Markdown غير الموثوقة من مصادر خارجية، قم بتنقية HTML المعروض باستخدام DOMPurify قبل الحقن في الصفحة لمنع هجمات XSS.

مرجع سريع لبناء الجملة. العناوين: `# H1` حتى `###### H6`. العريض: `text`. المائل: `*text*` أو `_text_`. عريض ومائل: `*text*`. يتوسطه خط (GFM): `~~text~~`. كود ضمن السطر: `` `code` ``. الرابط: `[text](https://url.com)`. الصورة: ``. الرابط التلقائي (GFM): `https://example.com` (رابط خام، بدون أقواس). قائمة غير مرتبة: `- item` أو `* item` أو `+ item`. قائمة مرتبة: `1. item`. قائمة متداخلة: مسافة البادئة بمسافات 2. اقتباس: `> quoted text`. اقتباس متعدد الأسطر: بادئة كل سطر بـ `>`. كتلة كود مسورة: علامات اقتباس عكسية ثلاثية (فتح وإغلاق) مع علامة لغة اختيارية. كتلة كود ذات مسافة بادئة: 4 مسافات أو علامة تبويب واحدة في بداية السطر. خط أفقي: `---` أو `***` في سطر خاص به. الجدول (GFM): `| col1 | col2 |\n|------|------|\n| val1 | val2 |`. قائمة المهام (GFM): `- [ ] todo` و `- [x] done`. مرور HTML: أي علامة HTML تعمل ضمن السطر. فاصل سطر صعب: مسافتان لاحقتان. الهروب من الحرف الخاص: شرطة مائلة عكسية قبل، على سبيل المثال `\*not italic\*`. استخدم المحول لأي حالة تربكك - تعرض المعاينة المباشرة بالضبط كيف يتم عرض كل نمط.