Hoe RST naar MD te converteren
- Voeg uw .RST-bestand toe - sleep het in het bovenstaande vak of klik om te bladeren.
- Converteer het naar .MD in enkele seconden.
- Download uw nieuwe .MD-bestand.
Wat u kunt verwachten
- Koppen, lijsten met opsommingstekens, links en inline code worden zuiver geconverteerd; RST-richtlijnen (
.. note::,.. code-block::) en rollen (:ref:,:func:) worden verwijderd of benaderd - controleer elke richtlijn na conversie. - Een
.. toctree::blijft niet behouden; u moet de inhoudsopgave na conversie handmatig opnieuw opbouwen. - Om een specifieke Markdown-variant te targeten, geeft u
-t gfm(GitHub Flavored Markdown) of-t commonmarkdoor aan Pandoc.
Veelgestelde vragen
Is de conversie van RST naar Markdown verliesvrij?
Nee. Basisinhoud - koppen, lijsten, links, inline code - wordt overgenomen, maar RST-richtlijnen en rollen hebben geen Markdown-equivalent en gaan verloren. Handmatige opschoning is normaal.
Wat is het belangrijkste verschil tussen RST en Markdown?
Beide zijn opmaaktalen in platte tekst, maar RST heeft een rijker systeem van richtlijnen en rollen ontworpen voor gestructureerde documentatie (Sphinx). Markdown is eenvoudiger en wordt vaker gebruikt voor READMEs en algemene notities.
Hoe converteer ik een hele map met RST-bestanden?
Pandoc verwerkt één bestand per opdracht; op Linux of macOS kunt u een loop gebruiken met
for f in *.rst; do pandoc "$f" -o "${f%.rst}.md"; done.Hoe houd ik Sphinx-documenten werkend na conversie naar Markdown?
Gebruik MyST Markdown in plaats van gewone Markdown - MyST ondersteunt richtlijnen en rollen in RST-stijl, zodat uw Sphinx-build blijft werken.
