Sådan konverterer du RST til MD
- Tilføj din .RST-fil - træk den ind i boksen ovenfor, eller klik for at gennemse.
- Konverter den til .MD på få sekunder.
- Download din nye .MD-fil.
Hvad du kan forvente
- Overskrifter, punktlister, links og inline-kode konverteres fejlfrit; RST-direktiver (
.. note::,.. code-block::) og roller (:ref:,:func:) udelades eller tilnærmes - gennemgå alle direktiver efter konvertering. - En
.. toctree::bevares ikke; du skal genopbygge indholdsfortegnelsen manuelt efter konvertering. - For at målrette en specifik Markdown-variant, kan du sende
-t gfm(GitHub Flavored Markdown) eller-t commonmarktil Pandoc.
Ofte stillede spørgsmål
Er RST til Markdown-konvertering tabsfri?
Nej. Grundlæggende indhold - overskrifter, lister, links, inline-kode - overføres, men RST-direktiver og roller har ingen Markdown-ækvivalent og går tabt. Manuel oprydning er normalt.
Hvad er den største forskel på RST og Markdown?
Begge er opmærkningssprog i ren tekst, men RST har et rigere system af direktiver og roller designet til struktureret dokumentation (Sphinx). Markdown er enklere og mere udbredt til README-filer og generelle noter.
Hvordan konverterer jeg en hel mappe med RST-filer?
Pandoc håndterer én fil pr. kommando; på Linux eller macOS kan du bruge et loop:
for f in *.rst; do pandoc "$f" -o "${f%.rst}.md"; done.Hvordan holder jeg Sphinx-dokumenter kørende efter konvertering til Markdown?
Brug MyST Markdown i stedet for almindelig Markdown - MyST understøtter direktiver og roller i RST-stil, så dit Sphinx-build fortsat fungerer.
