Hur man konverterar RST till MD
- Lägg till din .RST-fil - dra den till rutan ovan eller klicka för att bläddra.
- Konvertera den till .MD på några sekunder.
- Ladda ner din nya .MD-fil.
Vad du kan förvänta dig
- Rubriker, punktlistor, länkar och inline-kod konverteras rent; RST-direktiv (
.. note::,.. code-block::) och roller (:ref:,:func:) tas bort eller approximeras - granska varje direktiv efter konvertering. - En
.. toctree::bevaras inte; du måste bygga om innehållsförteckningen manuellt efter konvertering. - För att rikta in dig på en specifik Markdown-variant, skicka med
-t gfm(GitHub Flavored Markdown) eller-t commonmarktill Pandoc.
Vanliga frågor
Är konvertering från RST till Markdown förlustfri?
Nej. Grundläggande innehåll - rubriker, listor, länkar, inline-kod - följer med, men RST-direktiv och roller har ingen motsvarighet i Markdown och går förlorade. Manuell rensning är normalt.
Vad är den största skillnaden mellan RST och Markdown?
Båda är märkspråk i klartext, men RST har ett rikare system för direktiv och roller utformat för strukturerad dokumentation (Sphinx). Markdown är enklare och mer spritt för README-filer och allmänna anteckningar.
Hur konverterar jag en hel mapp med RST-filer?
Pandoc hanterar en fil per kommando; på Linux eller macOS kan du loopa med
for f in *.rst; do pandoc "$f" -o "${f%.rst}.md"; done.Hur behåller jag Sphinx-dokumentationen fungerande efter konvertering till Markdown?
Använd MyST Markdown istället för vanlig Markdown - MyST stöder direktiv och roller i RST-stil så att ditt Sphinx-bygge fortsätter att fungera.
