Markdown: نظّم معنى النص قبل الاهتمام بمظهره
Markdown مفيد للملاحظات والتوثيق لأن مصدره يبقى مقروءًا كنص. قيمته ليست في تكثير الرموز، بل في تمييز العنوان عن الفقرة والقائمة عن كلام متصل.
العناوين ليست مجرد حجم خط
ابدأ بعنوان الموضوع، ثم اجعل الأقسام التابعة في مستوى أقل. # و## يحددان مستويين مختلفين عندما تتبعهما مسافة؛ كتابة عنوان كبير لكل سطر تفقد المستند ترتيبًا يفهمه القارئ.
استخدم قائمة عندما تكون العناصر مستقلة، وفقرة عندما تحتاج شرح العلاقة بينها. لا تجعل التنسيق بديلًا عن كتابة جملة واضحة.
المراجع: CommonMark 0.31.2 — Structured text, headings and rendering differences
المعاينة تكشف البنية، لا كل بيئات النشر
قد تختلف إضافات Markdown بين المواقع. نجاح جدول أو امتداد في محرر لا يضمن أن نظامًا آخر يعرضه بالشكل نفسه، لذلك افحص النسخة في المكان الذي سيقرأها فيه الجمهور.
معاينة ToolRoof تعرض الناتج وتحول النص إلى HTML، لكنها لا تنفذ HTML الخام المدخل. الصور الخارجية تستبدل بوصفها، والروابط لا تُفتح من المعاينة؛ لا تنتظر منها نسخة مطابقة لصفحة ويب كاملة.
المراجع: CommonMark 0.31.2 — Structured text, headings and rendering differences
احتفظ بالمصدر إلى جانب النسخة المعروضة
مصدر Markdown أسهل للمقارنة عند تعديل مستند لاحقًا. أما HTML فيناسب العرض، ولا يلزم أن يعيد المصدر نفسه عند محاولة التحويل العكسي.
راجع الروابط والمحتوى قبل مشاركة الملف الناتج. المعاينة ليست شهادة بصحة المعلومات أو سلامة المواقع المرتبطة، ولا تجعل إدراج محتوى شخص آخر مباحًا دون حق استخدامه.
مثال: ملاحظة اجتماع قصيرة
ابدأ بالسطر # خطة الأسبوع، ثم ## الأولويات، ثم سطري القائمة - مراجعة الملخص و- إرسال المسودة. ينتج عنوان رئيسي وعنوان قسم وقائمة من عنصرين، لا أربع فقرات متشابهة.
إذا كتبت #خطة الأسبوع دون مسافة فلن تصبح عنوانًا بهذا الأسلوب. ومثال الشيفرة داخل علامات backtick يبقى نصًا معروضًا؛ ظهوره في المعاينة لا يعني تشغيله أو إثبات صحته.