MD-zu-RST-Konverter

Ένα αρχείο MD είναι ένα έγγραφο plain text που περιέχει Markdown, μια ελαφριά markup γλώσσα που δημιουργήθηκε από τους John Gruber και Aaron Swartz. Η μορφή χρησιμοποιεί μη αλφαβητικούς χαρακτήρες (όπως hashes για headers και αστερίσκους για έμφαση) για τον ορισμό syntax μορφοποίησης που είναι human-readable στην raw μορφή του και εύκολα convertible σε έγκυρο XHTML ή HTML. Είναι το de facto πρότυπο για documentation σε συστήματα version control όπως το Git.

Ως αυστηρά plain text, τα αρχεία MD μπορούν να ανοίξουν και να επεξεργαστούν σε οποιονδήποτε βασικό text editor όπως το Microsoft Notepad ή το Apple TextEdit. Για μια rendered προεπισκόπηση της μορφοποίησης, συνιστώνται εξειδικευμένοι editors όπως Obsidian, Typora ή Visual Studio Code.

Ένα αρχείο RST (reStructuredText) είναι ένα αρχείο plain text που περιέχει syntax markup που ορίζεται από το έργο Docutils, που χρησιμοποιείται κυρίως για τεχνικό documentation στο οικοσύστημα προγραμματισμού Python (PEP 287). Χρησιμοποιεί ένα ελαφρύ, indentation-sensitive syntax για τον ορισμό της δομής του εγγράφου, hyperlinks και μορφοποίησης, το οποίο έχει σχεδιαστεί να είναι αναγνώσιμο σε raw μορφή αλλά αρκετά ισχυρό για να γίνει compile σε HTML, LaTeX ή PDF μέσω του Sphinx documentation generator.

Ως μορφή plain text, τα αρχεία RST μπορούν να ανοίξουν και να επεξεργαστούν με οποιονδήποτε text editor, συμπεριλαμβανομένων των Visual Studio Code, Vim ή Notepad++. Ωστόσο, για να δείτε το rendered layout εγγράφου όπως προορίζεται, το αρχείο πρέπει να επεξεργαστεί από έναν parser όπως το docutils (χρησιμοποιώντας εντολές όπως rst2html) ή να χτιστεί μέσα σε ένα περιβάλλον έργου Sphinx.