لماذا أفضل reStructuredText على Markdown

تشرح هذه المقالة سبب تفضيل الكاتب reStructuredText (rST) على Markdown لكتابة الكتب التقنية. يُعدّ rST تمثيلًا متوسط الوزن لشجرة وثائق مجردة، ويقدم قابلية توسيع وتخصيص أفضل مقارنةً بنهج Markdown الخفيف. يُوضّح الكاتب ذلك من خلال أمثلة على إنشاء الصور ومعالجة التمارين، مُبينًا كيف تسمح التعليمات المُخصصة وتحويلات شجرة الوثائق في rST بإنشاء هياكل وثائق مُعقدة ووظائف يصعب تحقيقها في Markdown. وبالرغم من أنه يُقرّ بصعوبة تعلم بناء جملة rST، إلا أن الكاتب يدافع عن قوتها في مجال الوثائق الواسعة النطاق، خاصةً عندما تكون هناك حاجة إلى امتدادات وتحويلات مُخصصة، كما هو مُوضح في كتابه "المنطق للمبرمجين."