MarkdownCo

Markdown to Confluence Converter

الصق أو ارفع ملف Markdown واحصل على wiki markup الخاص بـ Confluence جاهزًا للاستخدام في Data Center أو Server أو Jira. العناوين والجداول وكتل الكود والروابط تُحوَّل إلى ما يقابلها في wiki markup، وصيغ LaTeX تمر دون أي تغيير.

مخرجات wiki markupcode macro مع وسوم اللغةصيغ LaTeX محفوظة
document.md
confluence.txt

Confluence Wiki Markup

تتحدّث النتيجة أثناء الكتابة. اضغط على Convert & Download لحفظها كملف.

كيفية تحويل Markdown إلى Confluence

من ملف .md إلى wiki markup جاهز لـ Confluence في ثلاث خطوات.

1

أضف محتوى Markdown

الصق Markdown في المحرر أو اسحب ملف .md وأفلته.

2

راجع wiki markup

تعرض اللوحة اليمنى wiki markup الخاص بـ Confluence أثناء الكتابة. تحقق من code macro والجداول قبل التصدير.

3

حوّل ونزّل

اضغط على Convert & Download لحفظ الـ wiki markup كملف .txt والاحتفاظ به في سجلّك.

أين يُستخدم wiki markup الخاص بـ Confluence

wiki markup الخاص بـ Confluence هو صيغة النص التي يقرأها Confluence Data Center وServer وJira بشكل مباشر. الكتابة بصيغة Markdown ثم التحويل عند التصدير يبقي الملفات المصدرية في git بينما يقرأ فريقك المحتوى داخل Confluence.

Confluence Data Center and Server pages
صفحات Confluence Data Center وServer عبر Insert > Markup
Jira descriptions and comments
أوصاف وتعليقات Jira التي تستخدم نفس wiki markup
Bulk migration into Confluence
ترحيل مستودعات README والوثائق إلى Confluence دفعة واحدة
Runbooks and technical notes
نشر runbooks والملاحظات التقنية المكتوبة بصيغة Markdown

كيف يُحوَّل Markdown إلى wiki markup في Confluence

كل عنصر في Markdown يُحوَّل إلى ما يقابله في wiki markup، وقد اختُبر التحويل على مستندات تقنية حقيقية تحتوي على كمّ كبير من الكود والصيغ الرياضية.

كتل الكود تتحول إلى code macro

كتل الكود المحاطة بعلامات backtick تُحوَّل إلى macro بصيغة {code:language=...} مع الحفاظ على وسم اللغة، بحيث يعمل تلوين بنية الكود بشكل صحيح في Confluence.

Code blocks become code macros

الجداول والروابط تُحوَّل دون أخطاء

جداول GFM تُحوَّل إلى صفوف ||header|| و|cell|؛ الروابط بصيغة [text](url) تصبح [text|url]. القوائم المتداخلة تحافظ على مستوى تداخلها.

Tables and links convert cleanly

صيغ LaTeX تمر دون أي تغيير

يتم رصد كتل $$ والصيغ المضمّنة $...$ وإبقاؤها كما هي حرفيًا — أوامر التباعد وفواصل الأسطر في المصفوفات والأقواس المُهرَّبة (escaped braces) تبقى سليمة، بحيث يمكن لـ macro رياضي في Confluence عرضها.

LaTeX math passes through untouched

العناوين والاقتباسات والخطوط الفاصلة تُحوَّل مباشرة 1:1

عناوين # تصبح h1. حتى h6.، والاقتباسات تصبح كتل {quote}، والخطوط الأفقية تصبح ----. بنية المستند تبقى محفوظة سطرًا بسطر.

Headings, quotes, and rules map 1:1

الأسئلة الشائعة: Markdown to Confluence

تغطي هذه الإجابات مخرجات wiki markup، وcode macro، ومعالجة الصيغ الرياضية، والتوافق مع Confluence Cloud.

كيف أحوّل Markdown إلى wiki markup الخاص بـ Confluence؟

الصق محتوى Markdown في المحرر أو ارفع ملف .md. تظهر معاينة wiki markup في لوحة النتيجة أثناء الكتابة. للحصول على النتيجة، اضغط على Convert & Download — يُحفظ الـ markup كملف .txt في سجلّ التحويلات. يتطلب ذلك تسجيل الدخول ويستهلك أرصدة؛ راجع صفحة الأسعار للتفاصيل.

ما الصيغة التي تُخرجها هذه الأداة؟

wiki markup الخاص بـ Confluence — وهي صيغة النص التي يقرأها Confluence Data Center وServer والمحرر القديم (عناوين h1.، *نص عريض*، macro بصيغة {code}، صفوف ||table||). وهي نفس عائلة الـ markup التي يستخدمها Jira في الأوصاف والتعليقات.

هل تعمل النتيجة في Confluence Cloud؟

جزئيًا. أزال المحرر الجديد في Confluence Cloud خيار Insert > Markup، لذا لا يمكنك لصق wiki markup فيه. يعمل wiki markup في Data Center وServer والمحرر القديم في Cloud وفي Jira. إذا كنت تستخدم المحرر الجديد في Cloud، الصق محتوى Markdown مباشرة — فهو يحوّل معظم البنية تلقائيًا عند اللصق.

كيف تُحوَّل كتل الكود؟

كتل الكود المحاطة بعلامات backtick تصبح macro بصيغة {code:language=...}. مُعرِّف اللغة الذي يلي علامة backtick الافتتاحية (```python، ```js) يُنقل إلى الـ macro، بحيث يطبّق Confluence تلوين بنية الكود الصحيح. الكتل التي لا تحمل وسم لغة تصبح {code:language=text}.

ماذا يحدث لصيغ LaTeX الرياضية؟

تمر دون أي تغيير حرفًا بحرف. يرصد المحوّل كتل $$ والصيغ المضمّنة $...$ قبل التحويل ويعيدها كما هي بعد ذلك، بحيث لا تتأثر أوامر التباعد مثل \, أو فواصل الأسطر في المصفوفات \\. لا يملك Confluence عرضًا مدمجًا للصيغ الرياضية — استخدم النتيجة مع تطبيق macro خاص بـ LaTeX على نسختك من Confluence.

هل جداول Markdown مدعومة؟

نعم. جداول Markdown بصيغة GitHub (GFM) تُحوَّل إلى markup الجداول في Confluence: صفوف العناوين تصبح خلايا ||header||، وصفوف المحتوى تصبح صفوف |cell|. تُحذف بنية محاذاة الأعمدة لأن جداول wiki markup لا تدعمها.