اختر جزءاً للنشر أو ملفاً للمشاركة
قد يحتاج موقع أو نظام محتوى إلى HTML حتى إن كنت تفضّل الكتابة باستخدام Markdown. افتح ملف .md أو الصق محتواه، وراجع النتيجة، ثم اختر بين جزء للمحتوى ومستند HTML كامل.
يعيد «نسخ HTML» جزءاً للمحتوى. أما «تنزيل HTML» فيضع المحتوى داخل مستند يتضمن تنسيقات وخطوطاً مضمنة للمعادلات. والنتيجتان مختلفتان: يحتاج الجزء إلى CSS من وجهته، بينما يحتوي الملف المنزّل على تنسيقات المستند.
محتوى HTML الناتج
بنية واضحة
تتحول العناوين والقوائم والاقتباسات والجداول والروابط إلى عناصر HTML. انتقل من «معاينة» إلى HTML لفحص الجزء الناتج.
شكلان مفيدان للمخرجات
انسخ جزءاً إلى نظام إدارة محتوى أو نزّل مستند HTML كاملاً للمراجعة والمشاركة. لا تحتاج إلى إزالة غلاف صفحة كاملة عندما لا تتطلب الوجهة سوى المحتوى.
أمثلة تقنية مضمّنة
يمكن تمييز شيفرة لغات البرمجة الشائعة. وتُعرض الصيغ المدعومة ومخططات Mermaid قبل التصدير. تظهر أخطاء التصدير بدلاً من استبدال المحتوى بصمت.
نسّق مستنداً مستقلاً
اضبط الخطوط والألوان قبل تنزيل HTML. وتُضمّن المخططات المعروضة بصيغة SVG، كما تُضمّن خطوط المعادلات في الملف المنزّل.
ابدأ بمستند تحتاج إليه فعلاً
قسم من مستند توثيق
حوّل جزءاً قصيراً من مقال ليتناسب مع تخطيط توثيق موجود.
## التثبيت ثبّت الحزمة و**تحقّق من النتيجة**. ```bash npm ci ``` > احتفظ بنسخة من مصدر Markdown الأصلي.
- مستوى العنوان مناسب للصفحة المضيفة.
- الأوامر واضحة القراءة.
- للاقتباس سياق مفيد.
جدول مقارنة لمدونة
احتفظ بالمعلومات الجدولية كخلايا HTML فعلية بدلاً من تحويلها إلى لقطة شاشة.
## تنسيقات التسليم | التنسيق | الخطوة التالية المناسبة | | --- | --- | | Markdown | تابع التحرير | | HTML | انشر على الويب | | PDF | شارك للقراءة |
- خلايا العناوين موجودة.
- النص مناسب للشاشات الضيقة.
- تمت مراجعة الروابط.
سير عمل عملي
الصق Markdown أو افتح ملفاً
استخدم المصدر الأصلي لمقالك أو ملف README. يُعرض HTML الخام خارج مجموعة وسوم التنسيق الصغيرة المدعومة كنص.
افحص العرضين
راجع المستند، ثم انتقل إلى HTML وتحقق من العناوين والروابط وبنية الجداول. تأكد من أن الوجهة تدعم العناصر التي تحتاج إليها.
اختر جزءاً أو مستنداً كاملاً
انسخ HTML إلى محرر نشر يقبل الشيفرة. نزّل HTML إذا أردت ملفاً منسقاً. اختبر النتيجة في وجهتها الفعلية قبل النشر.
راجع النتيجة قبل المشاركة
| المحتوى | ما الذي ينبغي فعله | ما الذي تتوقعه |
|---|---|---|
| جزء HTML | تحقّق من وسوم HTML وتنسيقات CSS المسموح بها في الوجهة. | قد ينقّي نظام إدارة المحتوى التنسيقات أو SVG أو الصيغ، حتى إن ظهرت في هذه المعاينة. |
| HTML مستقل | افتح الملف المنزّل بشكل منفصل. | يتضمن الملف تنسيقات المستند وخطوط المعادلات؛ أما الصور الخارجية المفعّلة فتظل معتمدة على خوادمها. |
| الروابط والبرامج النصية | راجع وجهات الروابط؛ لا تستخدم التحويل لتوزيع البرامج النصية. | يزيل المحوّل المحتوى النشط ويعرض HTML الخام غير المدعوم كنص. |
أسئلة حول سير العمل هذا
كيف أحوّل Markdown إلى HTML لموقع ويب؟
افتح ملف .md أو الصق المصدر وراجع المعاينة، ثم استخدم «نسخ HTML» للحصول على شيفرة المحتوى. اختر «تنزيل HTML» إذا احتجت إلى مستند كامل يتضمن التنسيقات. تحقّق من طريقة تعامل موقعك مع HTML الملصق قبل النشر.
ما الفرق بين «نسخ HTML» و«تنزيل HTML»؟
يعطيك «نسخ HTML» جزء المحتوى، بينما ينشئ «تنزيل HTML» مستنداً كاملاً يتضمن العنوان وتنسيقات المستند والمحتوى المعروض.
هل يمكنني تحويل جداول Markdown إلى جداول HTML؟
نعم. تتحول الجداول ذات الأعمدة المفصولة بشرطات عمودية إلى عناصر HTML للجداول. أما الجداول المعقدة ذات الخلايا المدمجة فتتجاوز صياغة Markdown الأساسية وقد تحتاج إلى تعديل يدوي.
هل يتضمن HTML الصيغ ومخططات Mermaid؟
تُعرض الصيغ المدعومة باستخدام KaTeX، وتُضمّن مخططات Mermaid بصيغة SVG. ويتضمن المستند المنزّل خطوط المعادلات؛ وقد يحتاج الجزء المنسوخ إلى تنسيقات من وجهته.
هل يمكنني لصق المخرجات في أي نظام لإدارة المحتوى؟
تحقّق من قواعد النظام أولاً. تقبل بعض المحررات مصدر HTML، بينما تعرض محررات أخرى الوسوم كنص أو تزيل SVG والصيغ. جرّب عينة صغيرة في سير النشر الفعلي.
هل يعمل HTML المنزّل بلا إنترنت بالكامل؟
تُضمّن تنسيقات المستند والمخططات المعروضة وخطوط المعادلات. أما الصور والروابط الخارجية فتظل تشير إلى مواقعها الأصلية ما لم تكن الصورة مضمّنة.
هل يُرفع Markdown لإجراء التحويل؟
يتم تحويل Markdown إلى HTML وتنزيل HTML في المتصفح. وحده الإجراء المنفصل «تنزيل PDF» يرسل المستند المعروض إلى هذا الموقع.
كيف تتعامل الأداة مع مستندك
- يتم تحليل Markdown وإنشاء HTML محلياً.
- HTML المنسوخ جزء من المحتوى؛ أما HTML المنزّل فهو مستند منسق.
- يُزال المحتوى النشط، لكن راجع الروابط وتأكد من قواعد نظام إدارة المحتوى.
مراجع التنسيقاتمرجع عناصر HTMLمواصفة CommonMark
أبلغ عن مشكلة يمكن إعادة إظهارهااذكر المتصفح والإعدادات المحددة ومثالاً صغيراً لا يتضمن معلومات سرية. لا ترسل مستندات خاصة عبر البريد الإلكتروني.
