Warum ich reStructuredText Markdown vorziehe

Dieser Beitrag beschreibt, warum der Autor reStructuredText (rST) gegenüber Markdown für das Schreiben technischer Bücher bevorzugt. rST ist eine mittelgewichtige Repräsentation eines abstrakten Dokumentbaums und bietet im Vergleich zum leichten Ansatz von Markdown eine bessere Erweiterbarkeit und Anpassbarkeit. Der Autor veranschaulicht dies anhand von Beispielen zur Bilderstellung und zur Bearbeitung von Übungen und zeigt, wie benutzerdefinierte Direktiven und Transformationen des Dokumentbaums in rST komplexe Dokumentstrukturen und Funktionalitäten ermöglichen, die in Markdown schwer zu erreichen sind. Obwohl er die möglicherweise weniger intuitive Syntax von rST anerkennt, plädiert der Autor für seine Leistungsfähigkeit bei der Erstellung umfangreicher Dokumentation, insbesondere wenn benutzerdefinierte Erweiterungen und Transformationen erforderlich sind, wie in seinem Buch "Logik für Programmierer" gezeigt.