Dieses Tool wandelt RST in Markdown um, also reStructuredText aus Sphinx, docutils oder PyPI-READMEs in GitHub Flavored Markdown mit Abschnitten, Codeblöcken, Tabellen, Admonitions, Fußnoten und Links. Den .rst-Text einfügen und das Markdown kopieren.
Zuletzt aktualisiert:
So funktioniert’s
RST einfügen
Eine README.rst oder Sphinx-Seite einfügen, eine .rst-Datei öffnen oder das Beispiel laden.
Markdown-Stil wählen
Admonitions als GitHub-Alerts oder Zitate, Aufzählungszeichen, Hervorhebung und Code-Fence einstellen.
Markdown übernehmen
Für GitHub, MkDocs, Docusaurus oder eine Migration nach MyST verwenden; die Vorschau zeigt das Ergebnis.
Funktionen
Ebenen aus den Unterstreichungen
Die Abschnittsebenen folgen der Reihenfolge, in der Unter- und Überstreichungsstile zum ersten Mal auftauchen – genau wie bei docutils.
Alle Blocktypen
Direktiven code-block, code und sourcecode, Literal-Blöcke nach ::, Doctest-Blöcke, Line Blocks und Blockzitate mit Quellenangabe.
Tabellen
Grid Tables, Simple Tables mit Fortsetzungszeilen sowie die Direktiven list-table und csv-table werden zu Markdown-Tabellen.
Verweise aufgelöst
Benannte und anonyme Linkziele, eingebettete URIs, Substitutionen mit Bildern sowie nummerierte und automatisch nummerierte Fußnoten.
Grenzen & Datenschutz
Dateien bis 10 MB werden verarbeitet, Eingaben über 256 KB in einem Web Worker. Hochgeladen wird nichts: Die Umwandlung läuft im Browser, und „Von URL öffnen“ lädt die Datei direkt von der eingegebenen Adresse.
Grenzen
include-Direktiven und Sphinx-Querverweise setzen das vollständige Projekt voraus und werden nicht aufgelöst. Bei Tabellen mit mehrzeiligem Kopf wird nur die erste Zeile zur Markdown-Kopfzeile. Feldlisten werden zu fetten Begriffen mit dem zugehörigen Text. Der Gegenweg: Markdown in RST.
Mehr zum Datenschutz auf der Datenschutzseite.
Häufige Fragen
Wie lässt sich RST ohne pandoc in Markdown umwandeln?
reStructuredText hier einfügen und das Ergebnis kopieren – installiert werden muss nichts.
Was passiert mit Sphinx-Direktiven wie toctree?
toctree, autodoc und include benötigen das gesamte Projekt. Sie werden übersprungen, und eine Warnung nennt jede einzelne.
Werden Admonitions unterstützt?
note, tip, important, warning, caution, danger, hint, seealso und die allgemeine admonition werden zu GitHub-Alerts oder Zitaten.
Was wird aus Rollen wie :ref: und :doc:?
Querverweise werden zu ihrem Text. :code:, :math:, :sup: und :sub: behalten ihre Bedeutung.
Kommen Umlaute aus älteren .rst-Dateien richtig an?
Ja. Beim Öffnen wird die Kodierung bestimmt – UTF-8, UTF-8 mit BOM oder ersatzweise Windows-1252.
Geht es auch von Markdown nach RST?
Ja, mit Markdown in RST, verlinkt über dem Ergebnis.