Word إلى Confluence Markdown: استيراد الوثائق إلى ويكي فريقك

كونفلوينس هي واحدة من أكثر ويكي الفريق استخدامًا على نطاق واسع، والعديد من المنظمات لديها مكتبات من وثائق وورد التي تنتمي إلى كونفلوينس. تحويل هذه الوثائق بشكل نظيف أكثر صعوبة مما يبدو Confluences Markdown الدعم لديه غرابة. هذا الدليل يُظهر لكَ الأكثر موثوقية Word إلى Confluence سير العمل.

هل Confluence يدعم Markdown؟

Confluence لديه دعم Markdown جزئي ، لكنه يعتمد على التنفيذ:

• Confluence السحابة يدعم ماكرو Markdown ويمكنه تقديم Markdown في سياقات معينة ، ولكن المحرر الأصلي هو شكل خاص به
• Confluence مركز البيانات / الخادم لديها أيضاً ماكرو Markdown
• أتلسيان روفو / محرر جديد الإصدارات الحديثة تحسنت Markdown دعم الملصق

الطريقة الأكثر موثوقية عبر جميع الإصدارات هي تحويل Word إلى Markdown مع WordToMD، ثم لصق محتوى Markdown باستخدام Confluences Markdown خاصية الاستيراد.

الطريقة 1: لصق Markdown عبر Confluence Editor

الخطوات

1. تحويل مستندك Word في WordToMD ثم انقر فوق Copy Markdown
2. في Confluence، افتح محرر الصفحة
3. من قائمة إدراج (+ رمز) ، حدد Markup أو Other Macros → Markup
4. اختر Markdown كاللغة
5. ارفق محتوى Markdown
6. انقر فوق إدراج

تعرض ماكرو Markup/Markdown المحتوى كنص غني داخل الصفحة. إنه لا يُحول إلى كتلة Confluence الأصلية، ولكنه يُظهر العناوين والجداول والقوائم بشكل صحيح.

الطريقة 2: Word استيراد الملف

Confluence Cloud لديه ميزة Word الاستيراد:

1. إنشاء صفحة جديدة Confluence
2. انقر فوق القائمة ... → استيراد Word المستند
3. حدد ملفك .docx

يعمل هذا على المستندات البسيطة ولكنه يميل إلى فقدان التنسيق المعقد. طريق Markdown يعطي المزيد من السيطرة.

الطريقة 3: تحويل إلى HTML

بعض الفرق تفضل HTML كشكل متوسط لأن Confluences editor يقبل HTML paste:

1. تحويل Word doc إلى Markdown مع WordToMD
2. تحويل Markdown إلى HTML باستخدام أداة على الإنترنت أو marked library
3. التبديل إلى Confluence محرر المصدر (Ctrl+Shift+D أو من شريط الأدوات)
4. اضعي HTML

هذا النهج يحافظ على التنسيق الأكثر تعقيداً ولكنه أكثر خطوات.

التوافق مع التنسيق

طاولات التعامل

Word الجداول تحويل إلى GFM النص التخطيط عبر WordToMD. Confluence’s Markdown macro renders these correctly:

| Project | Owner | Status |
|---|---|---|
| Website redesign | Alice | In progress |
| API migration | Bob | Complete |

لعمليات الجدول الأكثر تعقيداً، انظر Markdown الجداول: دليل كامل.

كتلة الشفرة في Confluence

Confluence لديه ماكرو كود بلوك الخاص به الذي يقدم تسليط الضوء على النصوص وأرقام السطر. بعد استيراد محتوى Markdown، قد ترغب في استبدال كتل الشفرة من ماكرو Markdown بمكروات محلية من كود Confluence Block لتحسين القراءة:

1. تحرير الصفحة
2. العثور على قسم الشفرة
3. إدراج ماكرو للكود
4. حدد اللغة لتسليط الضوء على النص
5. ضع الشفرة

المرجع: Markdown دليل كتلة الكود للترجمة القياسية.

اطلسية Confluence و ADF

Confluence تستخدم السحابة بشكل طبيعي تنسيق الوثيقة الأطلسية (ADF) مخطط JSON للمحتوى الغني. ماكرو Markdown يجلس فوق هذا. بالنسبة إلى الواردات البرامجية ، فإن Confluence REST API يقبل ADF مباشرة. إذا كنت تبني خط أنابيب آلي، تحويل Word → Markdown → ADF باستخدام المكتبات المتاحة.

بالنسبة لمعظم الفرق، فإن سير العمل اليدوي أسهل وأسرع.

نقل مكتبة وثائق

إذا كنت تقوم بنقل عشرات المستندات Word إلى Confluence:

1. تحويل جميع الملفات باستخدام WordToMD (أو مجموعة مع Pandoc للكميات الكبيرة)
2. قم بإنشاء مساحة Confluence وخطط لترتيب صفحة
3. استيراد الصفحات في أقسام، وتجميع الوثائق ذات الصلة تحت الصفحات الرئيسية
4. إضافة Confluence الميزات المحددة بعد الاستيراد: العلامات، القيود على الصفحة، @mentions

FAQ

هل يمكنني استخدام Markdown بشكل طبيعي في Confluence بدون الماكرو؟ في بعض تكوينات Confluence Cloud مع المحرر الجديد، يمكنك كتابة اختصارات Markdown وتحويلها تلقائيًا (e.g. ## يخلق H2). ولكن للصق الوثائق المحوّلة، ماكرو Markdown هو أكثر موثوقية.

تصميم عنواني ضاع بعد الاستيراد كل شيء يبدو كالنص الجسمي. هذا عادة ما يعني أن ماكرو Markdown غير نشط. يجب أن يكون Markdown داخل كتلة ماكرو Markup/Markdown ، وليس ملصقًا كنص عادي في المحرر القياسي.

الجداول تظهر على شكل أحرف البيوب الخام. نفس المشكلة يجب أن يكون المحتوى داخل ماكرو Markdown ، وليس في محرر النص القياسي.

هل هناك طريقة آلية لمزامنة Word الوثائق إلى Confluence الصفحات؟ نعم أدوات مثل Confluences الوثائق الخارجية الميزة، نسخ التمرير، أو النصوص المخصصة باستخدام Confluence REST API يمكن مزامنة Markdown الملفات إلى الصفحات تلقائيا.

النتيجة

النظيف Word إلى Confluence سير العمل هو: تحويل مع WordToMD، ثم الاستيراد عن طريق ماكرو Markdown. بالنسبة إلى الوثائق المعقدة أو عمليات الهجرة الجماعية، فإن النهج المتوسط HTML أو أتمتة REST API تمنح المزيد من التحكم. في كلتا الحالتين، فإن الاستخدام الصحيح لأساليب العناوين في Word قبل التحويل يضمن أن تكون تسلسل صفحة الصفحة سليمًا.