So konvertieren Sie RST in MD
- Fügen Sie Ihre .RST-Datei hinzu - ziehen Sie sie in das Feld oben oder klicken Sie, um zu suchen.
- Konvertieren Sie sie in wenigen Sekunden zu .MD.
- Laden Sie Ihre neue .MD-Datei herunter.
Was Sie erwartet
- Überschriften, Aufzählungslisten, Links und Inline-Code werden sauber konvertiert; RST-Direktiven (
.. note::,.. code-block::) und Rollen (:ref:,:func:) werden verworfen oder angenähert - prüfen Sie jede Direktive nach der Konvertierung. - Ein
.. toctree::bleibt nicht erhalten; Sie müssen das Inhaltsverzeichnis nach der Konvertierung manuell neu erstellen. - Um eine bestimmte Markdown-Variante anzusprechen, übergeben Sie
-t gfm(GitHub Flavored Markdown) oder-t commonmarkan Pandoc.
Häufig gestellte Fragen
Ist die Konvertierung von RST zu Markdown verlustfrei?
Nein. Basis-Inhalte - Überschriften, Listen, Links, Inline-Code - werden übernommen, aber RST-Direktiven und Rollen haben keine Markdown-Entsprechung und gehen verloren. Eine manuelle Bereinigung ist normal.
Was ist der Hauptunterschied zwischen RST und Markdown?
Beides sind Plain-Text-Markup-Sprachen, aber RST hat ein reichhaltigeres System an Direktiven und Rollen, das für strukturierte Dokumentationen (Sphinx) entwickelt wurde. Markdown ist einfacher und wird häufiger für READMEs und allgemeine Notizen verwendet.
Wie konvertiere ich einen ganzen Ordner mit RST-Dateien?
Pandoc verarbeitet eine Datei pro Befehl; unter Linux oder macOS nutzen Sie eine Schleife:
for f in *.rst; do pandoc "$f" -o "${f%.rst}.md"; done.Wie sorge ich dafür, dass Sphinx-Dokumente nach der Konvertierung in Markdown weiter funktionieren?
Verwenden Sie MyST Markdown anstelle von einfachem Markdown - MyST unterstützt Direktiven und Rollen im RST-Stil, sodass Ihr Sphinx-Build weiterhin funktioniert.
