المساعدة

ما هو Markzen؟

Markzen هو محرر مكتبي للغات الترميز خفيفة الوزن — Markdown وست لغات أخرى — مع معاينة حية ومصممة بالكامل. تكتب نصًا عاديًا مرمّزًا بعلامات ترقيم بسيطة على اليسار، ويقوم Markzen بعرضه كـ HTML منسق على اليمين أثناء الكتابة.

ما يميزه عن محرر Markdown العادي هو الرحلة ذهابًا وإيابًا. يقرأ Markzen ثماني لغات ترميز، ويعرض 30 امتدادًا مباشرًا (مخططات، رسوم بيانية، صيغ رياضية، نوتات موسيقية، لوحات شطرنج، رموز QR) داخل المستند، ويصدر إلى أكثر من عشرين تنسيقًا — كتب إلكترونية، Word، PowerPoint، LaTeX، دفاتر Jupyter والمزيد. اكتب مرة واحدة، وسلم النتيجة بأي شكل تقريبًا. المحول مدمج، لذلك لا توجد أدوات خارجية لتثبيتها.

يمكنك فتح ملف موجود أو البدء في الكتابة مباشرة — لا يوجد شرط لفتح ملف أولاً.

المحرر

اللوحة اليسرى هي محرر تعليمات برمجية كامل CodeMirror، وليست مربع نص عادي: فهي تحتوي على تمييز بناء الجملة للترميز الذي تكتبه، وشريط أدوات تنسيق (غامق، مائل، عناوين، قوائم والمزيد، بالإضافة إلى أزرار مخصصة لإدراج الروابط والصور — انظر الروابط والصور — ولإدراج جدول، انظر الجداول وجداول البيانات)، وبحث واستبدال. تعمل اختصارات التحرير القياسية — النسخ، اللصق، التراجع، الإعادة — كما تتوقع.

تكتب في واحدة من ثماني لغات ترميز خفيفة الوزن. هذه هي تنسيقات نص عادي تعبر عن البنية بعلامات الترقيم (# للعنوان، * للتأكيد) بدلاً من التنسيق المخفي، لذلك يظل المستند قابلاً للقراءة كنص وصديقًا للاختلافات في التحكم في الإصدار. يقرأ Markzen جميع اللغات الثماني ويقرر أي منها هو ملف من خلال امتداده — لا تختار التنسيق يدويًا أبدًا. يسرد التوافق الامتدادات التي تفتح أي لغة.

لكل لغة تقاليدها الخاصة ونظامها البيئي الحالي من المستندات؛ يعرض Markzen كل منها بلهجته الخاصة بدلاً من تحويل كل شيء إلى Markdown أولاً. BBCode هي اللغة التي لا تحتوي على معيار واحد — اخترع كل منتدى نسخته الخاصة — لذلك يقرأها Markzen بسخاء، ويقبل التهجئات الشائعة جنبًا إلى جنب ([list] أو [ul], [h1] أو [heading=1]) ويترك أي علامة لا يتعرف عليها مرئية كنص عادي بدلاً من ابتلاعها. لتبديل نوع الترميز الذي كتب به المستند، استخدم قائمة تحويل إلى في شريط الأدوات (انظر التحويل والتصدير أدناه).

لا يمكن لكل لغة التعبير عن كل شيء. يحمل شريط أدوات التنسيق نفس الأزرار في كل مستند، ولكن Markzen يكتب دائمًا الترميز الذي تحدده اللغة نفسها — لا يخترع أبدًا لهجة خاصة لتغطية فجوة. يتم تظليل الزر الذي لا تحتوي اللغة الحالية على رمز له. تتوفر الخطوط الغامقة والمائلة والعناوين والقوائم وكتل التعليمات البرمجية والروابط والصور والقواعد والجداول في جميع اللغات الثماني؛ يتم سرد الفجوات القليلة في التوافق. Markdown هو الذي يفاجئ الناس: لا توجد طريقة قياسية لتوسيط فقرة، لذلك لا يقدم Markzen أزرار محاذاة هناك بدلاً من كتابة شيء لا يحترمه سوى بعض القراء.

يتم تعيين حجم النص باستخدام زري تكبير الخط و تصغير الخط في شريط الأدوات. يمكن أيضًا إخفاء جزء المحرر بالكامل — عندما يكون كذلك، يصبح Markzen قارئًا خالصًا (انظر المعاينة المباشرة).

الروابط والصور

يحتوي شريط أدوات التنسيق على زرين مخصصين لوضع رابط أو صورة في المستند، ويفتح كل منهما نافذة منبثقة صغيرة في مكان المؤشر. رابط (Ctrl+K) — أو اضغط على Ctrl+K — يُدرج ارتباطًا تشعبيًا: اكتب نص الرابط وعنوانه، ويكتب Markzen الترميز الصحيح له. صورة يُدرج صورة بنفس الطريقة، مع بعض الخيارات الإضافية التي سيتم تغطيتها أدناه.

يتم كتابة كلاهما بالترميز الذي يستخدمه المستند الحالي — الرابط الذي يتم إدراجه في ملف AsciiDoc يظهر كـ AsciiDoc، وفي ملف Org كـ Org، وهكذا عبر جميع اللغات الثماني.

البدء من عنوان لديك بالفعل. الصق عنوان ويب في المستند، حدده، واضغط على Ctrl+K: يرى Markzen أن التحديد هو عنوان وليس كلمات، ويضعه في حقل العنوان في النافذة المنبثقة ويترك المؤشر في حقل النص الفارغ، في انتظار ما يجب أن يقوله الرابط. بدون ذلك، كان العنوان المحدد سيصبح النص المرئي للرابط — رابط يقرأ كعنوان URL مجرد. تُعد مسارات الملفات المطلقة عناوين أيضًا، على Windows وفي أي مكان آخر، لذا فإن نفس الاختصار يحول المسار الملصق إلى رابط لذلك الملف.

تحرير رابط أو صورة لديك بالفعل. ضع المؤشر في أي مكان على رابط أو صورة موجودة وافتح النافذة المنبثقة مرة أخرى (الزر، أو Ctrl+K): يتعرف Markzen على البنية، ويحمل نصها وعنوانها الحاليين في النافذة المنبثقة، ويستبدل كل شيء عند التأكيد — لذلك تقوم بتحريره في مكانه بدلاً من تضمين رابط جديد عن طريق الخطأ داخل الرابط القديم.

بالنسبة للصورة، تقدم النافذة المنبثقة أيضًا زر استعراض صورة لاختيار ملف من القرص بدلاً من كتابة مسار — يفتح في المجلد الذي أخذت منه صورة آخر مرة، ويتم الاحتفاظ به بشكل منفصل عن المجلد الذي تأتي منه مستنداتك — وخيار مهم واحد: ما إذا كانت الصورة مضمنة أم مرتبطة.

الصور المضمنة أو المرتبطة

عند إدراج صورة، يمكن لـ Markzen تخزينها في المستند بطريقتين:

• مرتبط — يشير المستند فقط إلى الصورة، عن طريق مسار الملف أو عنوان الويب. يظل ملف المستند صغيرًا، ولكن يجب أن تنتقل الصورة معه (أو تظل قابلة للوصول على عنوان URL الخاص بها)، وإلا فلن تظهر في مكان آخر. هذا هو الافتراضي.
• مضمن — يتم كتابة وحدات البايت الفعلية للصورة في المستند كنص (كتلة data: base64)، لذلك يكون الملف مكتفيًا ذاتيًا تمامًا: ملف واحد يحمل كل شيء، مع عدم وجود شيء يمكن أن يضيع. المقايضة هي الحجم — ينمو المستند بوزن الصورة، ولا يمكن للصورة المضمنة استخدام مسار نسبي.

اختر "مضمن" عندما تريد ملفًا واحدًا محمولًا لتسليمه؛ اختر "مرتبط" عندما تحتفظ بالصور بجانب المستند وتريد أن يظل الملف صغيرًا.

بالنسبة للصورة المرتبطة، يظهر خيار آخر: مسار نسبي. عندما تكون الصورة في مجلد المستند الخاص به (أو مجلد فرعي)، فإن تحديد هذا الخيار يكتب المرجع كمسار نسبي قصير بدلاً من مسار مطلق كامل، لذلك يستمر الرابط في العمل عند نقل المستند وصوره معًا. يتم تقديمه فقط عندما تكون الصورة داخل مجلد المستند — وإلا فلا يوجد مسار نسبي للكتابة.

تبقى الصور المضمنة مرتبة في المحرر. الصورة المضمنة بـ base64 هي جدار طويل من النص كان من شأنه أن يدفن الأسطر المحيطة بها، لذلك يقوم Markzen بطي كل واحدة في شريحة صغيرة تعرض نوعها وحجمها (على سبيل المثال 🖼 webp · 38 KB). الشريحة للعرض فقط — النص الأساسي لم يتم المساس به، لذلك فإن الحفظ أو النسخ أو القص يحمل دائمًا الصورة الكاملة، ويتخطى المؤشر الشريحة كوحدة واحدة.

الملفات وعلامات التبويب والحفظ

يتيح لك Markzen فتح أي عدد تريده من المستندات في وقت واحد، كل منها في علامة تبويب خاصة به، بحيث يمكنك العمل عبر عدة ملفات والتبديل بينها بحرية. لا تحتاج إلى فتح ملف للبدء — ابدأ الكتابة في المستند الفارغ الموجود بالفعل، أو استخدم أزرار الملفات في شريط الأدوات:

• مستند جديد — يفتح قائمة قصيرة (إنشاء جديد) تسرد لغات الترميز الثماني؛ اختر واحدة لبدء مستند جديد وفارغ مكتوب بتلك اللغة، في علامة تبويب جديدة.
• فتح ملف Markdown — تصفح ملفًا موجودًا وافتحه. يقبل المنتقي جميع تنسيقات الترميز الثماني، ويختار Markzen التنسيق الصحيح من امتداد الملف. يفتح في المجلد الذي أخذت منه مستندًا آخر مرة، ويتم تذكره بين الجلسات، حتى لا تبدأ من الصفر في كل مرة.
• حفظ — يعيد كتابة المستند النشط إلى ملفه. المستند الذي لم يتم حفظه مطلقًا ينتقل إلى حفظ باسم حتى تتمكن من تسميته أولاً.
• حفظ باسم — يحفظ المستند النشط في ملف جديد، مع ترك أي ملف أصلي دون تغيير.

يمكنك أيضًا سحب ملف من مدير الملفات الخاص بك وإفلاته في النافذة لفتحه.

كل مستند مفتوح هو علامة تبويب عبر الجزء العلوي من النافذة. يتم تمييز علامة التبويب غير المحفوظة بنقطة، وتحمل علامة التبويب التي لا تحتوي على ترميز Markdown شارة تنسيق صغيرة (على سبيل المثال adoc). يغلق الرمز × الموجود على علامة التبويب — وإغلاق مستند به تغييرات غير محفوظة لا يتجاهلها بصمت أبدًا: يظهر شريط مضمن على علامة التبويب حتى تتمكن من حفظ أو تجاهل أولاً.

أثناء فتح المستند، يراقب Markzen ملفه على القرص. إذا تغير الملف في برنامج آخر ولم يكن لديك أي تعديلات غير محفوظة خاصة بك، يسحب Markzen الإصدار الجديد تلقائيًا؛ إذا كان لديك تعديلات غير محفوظة، فإنه يسأل أولاً — يتيح لك شريط إعادة تحميل المضمن تحديد ما إذا كنت تريد أخذ الإصدار الموجود على القرص أو الاحتفاظ بإصدارك الخاص.

معاينة مباشرة

الجزء الأيمن هو المستند معروضًا كـ HTML منسق، ويتم تحديثه مباشرةً أثناء الكتابة. تعمل الروابط، وتتراصف الجداول، ويتم عرض التعليمات البرمجية في كتلة أحادية المسافة، وتحصل قوائم المهام على مربعات اختيار، وترسم كل كتلة امتداد عرض (انظر أدناه) شكلها في مكانها. المعاينة هي صورة مطابقة لما سيبدو عليه تصدير HTML أو PDF.

إذا تم فتح مستند Markdown بـ كتلة YAML front-matter — قسم --- key: value --- الذي تضعه أدوات مثل Jekyll وHugo وObsidian في الأعلى — فإن Markzen يعرضه كبطاقة بيانات وصفية مرتبة فوق المستند، بدلاً من السماح لـ --- الختامية بالتحول إلى عنوان عشوائي.

أوضاع التخطيط

مجموعة من ثلاثة أزرار شريط الأدوات تحدد ما تعرضه النافذة:

• عرض مقسم — المحرر والمعاينة جنبًا إلى جنب. اسحب الفاصل لتغيير مقدار المساحة التي يحصل عليها كل منهما.
• إظهار المحرر — المحرر وحده، يملأ النافذة للكتابة الخالية من التشتت.
• إظهار المعاينة — المعاينة وحدها، قارئ نظيف بعرض كامل.

جدول المحتويات

يفتح زر جدول المحتويات لوحة يتم إنشاؤها تلقائيًا من كل عنوان في المستند (#، ##، ###، ...). انقر فوق أي إدخال لتمرير المعاينة إلى هذا القسم. يعرض أي عنوان يحتوي على عناوين فرعية تحته سهمًا: انقر فوقه لـ طي هذا القسم وإخفاء عناوينها المتداخلة، أو توسيع لإعادتها — حتى تتمكن من طي مخطط طويل إلى الأجزاء التي تعمل فيها فقط. تحد الأزرار الصغيرة 2 / 3 / 4 في رأس اللوحة المخطط إلى عمق العنوان هذا — وهو مفيد في مستند طويل عندما تريد فقط المستويات العليا في العرض — ويؤدي النقر فوق الزر النشط مرة أخرى إلى إعادة كل مستوى. تتغير أبعاد اللوحة عن طريق سحب حافتها اليسرى وتنهار لتحرير مساحة القراءة. إنها أداة مساعدة للتنقل داخل التطبيق فقط — ولا تظهر أبدًا في التصدير.

توفير المخطط الخاص بك. إذا لم تكن العناوين هي المخطط الذي تريده، يمكن للمستند أن يحمل مخططه الخاص. كتلة محاطة بعلامة markzen يكون سطرها الأول toc تستبدل اللوحة التي تم إنشاؤها بالقائمة المكتوبة تحتها:

`markdown

```markzen
toc
- [Introduction](#intro)
  - [Background](#background)
- [Results](#results)
```

تحدد المسافة البادئة المستوى، ويشير كل إدخال إلى مرساة يجب أن تكون موجودة في المستند نفسه — عنوان أعطيته id صريحًا، أو <a id="intro"></a> عادي. لا ترسم الكتلة نفسها شيئًا: إنها بيانات وصفية تقرأها اللوحة.

الجداول وجداول البيانات

تنتقل الجداول بسلاسة بين Markzen وأي جدول بيانات. الصق نصًا مفصولًا بعلامات جدولة - منسوخًا من Excel أو Google Sheets أو Word أو جدول ويب - في المحرر ويقوم Markzen بتحويله إلى جدول مناسب مكتوب بلغة ترميز المستند الخاصة به، بدلاً من إسقاط جدار من أحرف الجدولة. قارئ اللصق يدرك علامات الاقتباس (يتعامل بشكل صحيح مع الخلايا التي تحتوي نفسها على علامات جدولة أو فواصل أسطر أو علامات اقتباس) ولا يتم تشغيله إلا عندما تحتوي الحافظة على شبكة مستطيلة نظيفة من عمودين على الأقل؛ أي شيء آخر يتم لصقه كنص عادي.

يمكنك أيضًا بدء جدول من الصفر. يفتح زر إدراج جدول في شريط الأدوات شبكة صغيرة - اسحب عبرها لاختيار عدد الصفوف والأعمدة التي تريدها، ويكتب Markzen جدولًا فارغًا بهذا الحجم بلغة ترميز المستند الخاصة به، جاهزًا للكتابة فيه. الصف الأول هو صف الرأس.

العكس صحيح أيضًا. مرر مؤشر الماوس فوق أي جدول معروض في المعاينة ويظهر زر نسخ في زاويته: يقوم بنسخ الجدول مرة أخرى كنص مفصول بعلامات جدولة يتم إسقاطه مباشرة في خلية جدول بيانات أو مستند Word. أزرار النسخ هذه هي مجرد وسيلة راحة للمعاينة - يتم تجريدها من كل عملية تصدير وتحويل، لذلك يحتوي الملف المشترك على الجدول النظيف فقط.

إضافات العرض

يوسع Markzen الترميز القياسي من خلال كتل التعليمات البرمجية المسورة. تحدد علامة اللغة مباشرة بعد علامات الاقتباس الثلاثية الافتتاحية كيفية عرض الكتلة: علامة يتعرف عليها Markzen كإضافة ترسم شكلاً حيًا بدلاً من إظهار التعليمات البرمجية.

يتم رسم كل نوع من الأشكال بواسطة محرك العرض الخاص به، ويقوم Markzen بجلب محرك في المرة الأولى التي يطلب فيها المستند ذلك فعليًا بدلاً من تحميلها جميعًا عند التشغيل — وهذا هو السبب في أن التطبيق يبدأ على الفور تقريبًا، ولماذا قد يستغرق الرسم البياني الأول من نوع معين لحظة للظهور بينما يظهر كل رسم بياني لاحق على الفور.

على سبيل المثال، هذا المصدر:

```mermaid
graph LR
  A --> B --> C
```

يتم عرضه كمخطط انسيابي مباشر، وليس قائمة تعليمات برمجية — ويظل مخططًا انسيابيًا في صادرات PDF و HTML أيضًا.

يتم تضمين الرسوم البيانية والمخططات والرياضيات والتدوين الموسيقي ولوحات الشطرنج والغو ورموز QR والمزيد — تسرد التوافق كل واحد منها مع علامته.

لكل إضافة علامة لغتها الخاصة (mermaid، chartjs، katex، abc، chess، ...). يمكنك مزج العديد منها كما تريد مع النثر العادي في مستند واحد — يتم عرضها جميعًا معًا. يعتمد ما إذا كان الشكل لا يزال شكلاً بمجرد أن يغادر المستند Markzen على المكان الذي ترسله إليه — انظر التحويل والتصدير أدناه.

الصيغ داخل جملة

يمكن أن تكون الصيغة الرياضية كتلة خاصة بها — كتلة katex أو asciimath، تقف بمفردها وتتمركز مثل معادلة في كتاب مدرسي. يعمل هذا في جميع لغات الترميز الثمانية.

يمكن أن تكون الصيغة أيضًا داخل جملة، بحيث تقرأ "المساحة هي ط نق تربيع" كسطر واحد من النثر مع رموز حقيقية فيه. يعتمد ذلك على لغة الترميز التي تحتوي على تدوين لها، وكل واحدة تكتبها بشكل مختلف — التدوين لكل لغة موجود في التوافق.

Textile و BBCode هما الاستثناءان، وهذا حد لتلك اللغات بدلاً من Markzen: لم تحدد أي منهما طريقة لكتابة الرياضيات. في مستند Textile أو BBCode، يجب أن تكون الصيغة كتلة خاصة بها. لا يضيع شيء — يتم عرض الصيغة، وتظل موجودة عند التصدير — ببساطة لا يمكن نسجها في سطر من النثر.

وضع وتغيير حجم الشكل

مرر مؤشر الماوس فوق شكل معروض في المعاينة وستظهر لوحة صغيرة بجانبه: أزرار محاذاة (يسار، وسط، يمين) و — لأنواع الأشكال التي يمكن تغيير حجمها — مربعات عرض و ارتفاع بالبكسل. يمسح remove style block هذه الخيارات مرة أخرى.

لا يتم الاحتفاظ بهذا الاختيار في مكان غير مرئي: تكتب اللوحة ذلك في المستند، ككتلة قصيرة تحمل علامة markzen توضع مباشرة قبل الشكل الذي تنطبق عليه.

```markzen
style
align center
width 480
```

لذلك ينتقل التخطيط مع الملف — إنه جزء مما تحفظه وتسلمه وتصدره، على أي جهاز. يمكنك أيضًا كتابة الكتلة يدويًا: توجيه واحد لكل سطر، align (left أو center أو right)، width و height بالبكسل، ينطبق دائمًا على الكتلة الموجودة أسفلها مباشرةً.

تنسيق مستند واحد باستخدام CSS

يمكن لمستند Markdown أيضًا أن يحمل ورقة أنماطه الخاصة، في كتلة مسورة تحمل علامة style:

```style
h2 { color: #b03030; border-bottom: 2px solid #b03030; }
blockquote { font-style: italic; }
```

تنطبق القواعد على معاينة هذا المستند وعلى صادراته بتنسيق PDF و HTML، بالإضافة إلى أي قالب نمط نشط — وهي طريقة لإعطاء مستند واحد مظهرًا خاصًا به دون تغيير إعداداتك لكل شيء آخر. المحددات العادية فقط: القواعد مثل @media و @keyframes غير مدعومة، وتعمل الكتلة في مستندات Markdown فقط.

تحويل وتصدير

قائمة تحويل إلى في شريط الأدوات هي المكان الذي يغادر فيه المستند المكتمل Markzen. تقوم بشيئين متميزين.

التحويل إلى لغة ترميز أخرى. ضمن ترميز خفيف، أعد كتابة المستند المفتوح كأي من لغات الترميز السبع الأخرى — AsciiDoc، BBCode، Djot، MediaWiki، Org، reStructuredText أو Textile. مفيد عندما تريد الويكي MediaWiki، أو المنتدى BBCode، أو الناشر AsciiDoc، أو كنت تنقل الملاحظات بين الأنظمة البيئية. تظهر كل من اللغات الثماني مرة واحدة في القائمة، كلغة ترميز: المستند المحفوظ كـ MediaWiki من هنا هو نفس الملف الذي ستحصل عليه في أي مكان آخر.

التصدير إلى تنسيق مكتمل. قم بتسليم المستند إلى المحول المرفق، والذي يصدر أكثر من عشرين تنسيقًا للمستندات، مجمعة حسب الغرض منها:

الفئة	التنسيقات
كتب إلكترونية	EPUB 3، FictionBook2
معالج نصوص	Microsoft Word (.docx)، OpenDocument (.odt)، Rich Text Format (.rtf)
عرض تقديمي	Microsoft PowerPoint (.pptx)، reveal.js (.html)
تنضيد	InDesign ICML، LaTeX (.tex)، Typst (.typ)
XML	DocBook، JATS، OpenDocument XML، TEI Simple
دفتر ملاحظات	Jupyter Notebook (.ipynb)
مخطط تفصيلي	OPML (.opml)

يتم شحن المحول داخل Markzen — لا يوجد شيء إضافي لتنزيله أو تكوينه. إلى جانب هذه، توجد ثلاثة مخرجات سريعة على شريط الأدوات: حفظ بصيغة PDF و حفظ بصيغة HTML يقومان بتصدير المستند المعروض تمامًا كما تمت معاينته (قالب النمط، الخطوط، والأشكال الإضافية متضمنة)، و طباعة يرسله إلى طابعة. ينتقل خط الكود داخل الملف المصدر، لذلك تظهر كتلة الكود أو الرسم التخطيطي ASCII على جهاز القارئ بالشكل الذي رأيته، سواء كان لديهم هذا الخط مثبتًا أم لا.

ما ينتقل وما لا ينتقل. يبقى شكل امتداد العرض شكلاً فقط حيث يمكن للتنسيق الهدف أن يحتوي على صورة، لذلك يغادر المستند Markzen عبر أحد مسارين:

• كالمستند الذي تراه — المخرجات الثلاثة لشريط الأدوات الموصوفة للتو (PDF، HTML، الطباعة) وخمسة من التنسيقات في الجدول أعلاه: EPUB 3، Microsoft Word (.docx)، OpenDocument (.odt)، Microsoft PowerPoint (.pptx) و Rich Text Format (.rtf). يتم كتابة الرسوم البيانية والصيغ والنوتات الموسيقية كصور وتصل سليمة.
• كنص مصدر المستند — كل هدف آخر، وكل تحويل إلى لغة ترميز أخرى. يتم تحويل النثر والعناوين والقوائم والجداول والروابط؛ تصل كتلة mermaid أو katex ككتلة كود عادية تحتوي على المصدر الذي كتبته، لأن هذه التنسيقات لا تحتوي على شكل لـ Markzen لتقديمه لها.

لذلك، من الأفضل تسليم المستند المبني حول الرسوم البيانية كـ PDF أو HTML أو EPUB أو Word أو OpenDocument أو PowerPoint أو RTF. لا يزال LaTeX و Typst و reveal.js والباقي يمنحك المستند بأكمله — مع ترك مصدر كل شكل في مكانه، جاهزًا لأدوات هذا النظام البيئي الخاصة.

التصدير من سطر الأوامر

يعمل Markzen أيضًا دون فتح نافذة. مرر الملف التنفيذي لـ Markzen ملفًا مصدرًا و-o مع مسار إخراج، وسيقوم بعرض المستند وكتابة التصدير مباشرة إلى القرص:

markzen.exe report.md -o report.pdf

يمكن أن يكون المصدر أيًا من تنسيقات الترميز الثمانية التي يقرأها Markzen؛ ويكون الإخراج ملف PDF أو HTML، يتم اختياره بواسطة امتداد اسم الإخراج. يمر التصدير بنفس عملية العرض مثل التطبيق نفسه، لذلك تظهر الرسوم البيانية والصيغ وجميع كتل الامتدادات الأخرى كأشكال حية. تستخدم عمليات التصدير قالب النمط والخطوط الافتراضية — يعمل سطر الأوامر في ملفه الشخصي النظيف الخاص به، منفصلاً عن التطبيق، مما يعني أيضًا أنه يعمل بشكل جيد بينما يكون Markzen مفتوحًا بالفعل.

يمكن تصدير عدة مستندات في استدعاء واحد — أعطِ أي عدد من أزواج source -o output وسيقوم تشغيل واحد بعرضها جميعًا، بجزء بسيط من تكلفة التشغيل مرة واحدة لكل ملف:

markzen.exe a.md -o a.pdf b.adoc -o b.html c.rst -o c.pdf

الخطوط والمظهر

تم تصميم Markzen لجعل المستند يبدو منسقًا بدلاً من أن يكون عامًا. توجد عناصر التحكم الخاصة بذلك معًا في شريط الأدوات خلف زر النمط والخطوط، حتى تتمكن من تعديلها أثناء القراءة؛ يعيش المظهر ولغة الواجهة في الإعدادات ← العرض.

قالب النمط

يقدم النمط خمسة أنماط معاينة: قياسي، GitHub، كتاب، حديث، بسيط. القالب الذي تختاره هو أيضًا النمط المطبق على صادرات PDF و HTML، لذلك يحدد كيفية قراءة المستند المشترك — اختر كتاب أو حديث لشيء ستقوم بتسليمه، وبسيط للقراءة الخالية من التشتيت. يقوم القالب بتنسيق المعاينة فقط، وليس المحرر أبدًا.

الخطوط

تحدد ثلاثة منتقيات في نفس اللوحة خطًا منفصلاً لكل نوع من أنواع النص — عنوان و نص أساسي و رمز — وهذا ما يجعل مستند Markzen يبدو منسقًا:

• العناوين — Oswald, Playfair Display, Merriweather, Raleway, Montserrat, Lora, Libre Baskerville, Bebas Neue, Abril Fatface, Cinzel.
• النص الأساسي — Inter, Roboto, Georgia, Lato, Source Serif 4, Nunito, PT Serif, Crimson Text, Libre Franklin, Open Sans.
• التعليمات البرمجية — JetBrains Mono, Source Code Pro, Cascadia Mono, Fira Mono.

تم اختيار خطوط التعليمات البرمجية لخاصية تتجاوز المظهر: كلها ترسم أحرف رسم المربع (│ ├ └ ─) التي تتكون منها قوائم الشجر والرسوم البيانية ASCII، لذلك تحتفظ شجرة الدليل الملصقة في كتلة التعليمات البرمجية بشكلها بدلاً من أن تتكسر إلى فجوات. وهي أيضًا المتغيرات الخالية من الربط — يقوم الخط الذي يحتوي على روابط بإعادة رسم != كـ ≠ واحد، وهو أمر ممتع في محرر التعليمات البرمجية وخاطئ في مستند يهدف إلى إظهار ما يقوله الملف بالفعل. يتم شحن JetBrains Mono و Source Code Pro داخل Markzen، لذلك يعملان على جهاز لم يرهما من قبل وبدون أي اتصال على الإطلاق.

حجم النص

تغير زرا تكبير الخط و تصغير الخط في شريط الأدوات حجم النص.

المظهر واللغة

في الإعدادات ← العرض:

• السمة — فاتح أو داكن. الافتراضي: فاتح.
• اللغة — واجهة Markzen نفسها مترجمة إلى أكثر من خمسين لغة، بما في ذلك النصوص من اليمين إلى اليسار (العربية، العبرية) و CJK (الصينية، اليابانية، الكورية).

التوافق

الجداول المرجعية: ما تدعمه كل لغة ترميز، وكل نوع من الأشكال الحية التي يمكن لـ Markzen رسمها. كل ما هنا يدور حول ما يعمل أين — التفسيرات موجودة في الأقسام أعلاه.

ما يمكن لكل لغة ترميز فعله

لغة الترميز	تفتح الملفات التي تنتهي بـ	الأشكال الحية	لوحة المحتويات	صيغة في جملة	لا يمكن التعبير عنها
Markdown	.md, .markdown	الكل	نعم	$…$	محاذاة النص
AsciiDoc	.adoc, .asciidoc, .asc	الكل ما عدا style	نعم	كتلة فقط	يتوسطه خط
reStructuredText	.rst, .rest	الكل ما عدا style	نعم	$…$	يتوسطه خط
Org	.org	الكل ما عدا style	نعم	$…$	محاذاة لليسار واليمين
Textile	.textile	الكل ما عدا style	نعم	كتلة فقط	—
Djot	.dj	الكل ما عدا style	نعم	$`…`	—
MediaWiki	.wiki, .mediawiki, .wikitext	الكل ما عدا style	نعم	<math>	الكود المضمن، يتوسطه خط، اقتباس كتلة، محاذاة النص
BBCode	.bbcode, .bb	الكل ما عدا style	نعم	كتلة فقط	—

الأشكال الحية — كتلة style هي الاستثناء الوحيد: فهي تطبق CSS على المستند نفسه، وهو ما يدعمه Markdown فقط. كل نوع آخر من الأشكال يعمل في كل لغة. في مستند BBCode، تُكتب الكتلة [code=mermaid]…[/code] بدلاً من استخدام علامات الاقتباس الخلفية؛ في MediaWiki، <syntaxhighlight lang="mermaid">…</syntaxhighlight>.

لا يمكن التعبير عنها — هذه هي قيود لغات الترميز نفسها، وليست قيود Markzen: حيث لا تحتوي اللغة على تدوين لشيء ما، لا يقدم Markzen زرًا لذلك بدلاً من كتابة لهجة خاصة لا يمكن قراءتها إلا بواسطته. انظر الصيغ داخل جملة لصف الرياضيات.

كل نوع من الأشكال

اكتب العلامة بعد علامات الاقتباس الخلفية الثلاثة الافتتاحية — ```mermaid — وتصبح الكتلة شكلاً.

الفئة	الشكل	علامة الكتلة	ملاحظات
الرسوم البيانية	Mermaid	mermaid	المخططات الانسيابية، التسلسل، الفئة، جانت، ER، الحالة
	Graphviz	graphviz	لغة DOT
	Cytoscape	cytoscape	رسوم بيانية للشبكة؛ تحريك وتكبير في المعاينة
	Markmap	markmap	خريطة ذهنية من مخطط نقطي؛ انقر للطي
	Timeline	timeline	جدول زمني عمودي للأحداث
رسوم بيانية للبرمجيات	Nomnoml	nomnoml	UML
	PlantUML	plantuml	UML — الشكل الوحيد الذي يحتاج إلى اتصال بالإنترنت
	DBML	dbml	رسوم بيانية لمخطط قاعدة البيانات
الرسوم البيانية	Chart.js	chartjs	شريطي، خطي، دائري، راداري
	Vega-Lite	vega-lite	رسوم بيانية تصريحية من JSON
	ECharts	echarts	رسوم بيانية تفاعلية كبيرة
تطوير تكنولوجيا المعلومات	Pseudocode	pseudocode	خوارزميات منسقة
	Tabulator	tabulator	جدول تفاعلي قابل للفرز
	Bytefield	bytefield	تخطيطات حقول البت والبايت
	QR Code	qrcode
	Railroad	railroad	رسوم بيانية نحوية
	WaveDrom	wavedrom	رسوم بيانية للتوقيت الرقمي
الرياضيات	KaTeX	katex	أيضًا $…$ في جملة — انظر الجدول أعلاه
	AsciiMath	asciimath	تدوين الرياضيات بالنص العادي
الرسوم البيانية	function-plot	fnplot	رسم منحنى دالة
	JSXGraph	jsxgraph	هندسة تفاعلية
	Plotly	plotly	رسوم بيانية علمية وثلاثية الأبعاد
العلوم	SMILES	smiles	رسوم بيانية للتركيب الكيميائي
الموسيقى	ABC Notation	abc	نوتة موسيقية من نص عادي
	VexFlow	vexflow	مدرجات محفورة
	VexChords	vexchords	رسوم بيانية لأوتار الجيتار
	ChordPro	chordpro	أوتار فوق الكلمات
	MusicXML	musicxml	نوتات كاملة
الألعاب	Chess	chess	لوحة من وضع FEN
	Go Board	goboard	9×9، 13×13 و 19×19
المستند	Markzen	markzen	غير مرئي: يضع ويحدد حجم الشكل تحته، أو يتجاوز لوحة المحتويات
	Style	style	غير مرئي: CSS لهذا المستند — Markdown فقط

ارتباطات الملفات

على نظام Windows، يمكن للمثبت تسجيل Markzen كمعالج لكل نوع ملف ترميز يقرأه - جميع الامتدادات الخمسة عشر المدرجة في التوافق، عبر جميع اللغات الثماني. بمجرد التسجيل، يؤدي النقر المزدوج على أحد هذه الملفات في Explorer إلى فتحه مباشرة في Markzen، وإذا تم تثبيت عدة برامج تحرير، فلا يزال بإمكانك اختيار Markzen عبر "فتح باستخدام...".

اختصارات لوحة المفاتيح

المفتاح	الإجراء
Ctrl+S	حفظ
Ctrl+Shift+S	حفظ باسم
Ctrl+ + / Ctrl+ -	زيادة / تقليل حجم النص

تعمل اختصارات المحرر القياسية - البحث، الاستبدال، النسخ، اللصق، التراجع، الإعادة - واختصارات شريط أدوات التنسيق (غامق Ctrl+B، مائل Ctrl+I، عنوان Ctrl+H، رابط Ctrl+K، والمزيد) في جزء المحرر. يوجد اختصار تنسيق فقط حيث تحتوي العلامة الحالية على البنية - Ctrl+D لا يفعل شيئًا في مستند AsciiDoc، الذي لا يحتوي على خط يتوسطه (انظر المحرر).

نصائح

• إخفاء المحرر للقراءة. عرض واحد مع عرض المعاينة يحول Markzen إلى قارئ نظيف، وتتيح لك قوالب الأنماط الخمسة تحديد شكله.
• مستند واحد، كل أنواع المحتوى. يمكن أن يجلس مخطط Mermaid الانسيابي ومعادلة KaTeX ونوتة موسيقية بجانب النثر العادي - يتم عرضها جميعًا معًا وتظل جميعها سليمة عند التصدير إلى PDF و HTML.
• قالب النمط هو مظهر التصدير. أي قالب تختاره هو النمط المدمج في إخراج PDF و HTML، لذا اضبطه قبل التصدير.
• اكتب بلغة الترميز التي تفضلها، وسلم بالتنسيق الذي يحتاجونه. قم بالمسودة في Markdown (أو أي من الثمانية)، ثم استخدم التحويل إلى لملف Word أو مجموعة شرائح أو كتاب إلكتروني أو مصدر LaTeX - لا توجد أدوات منفصلة مطلوبة.