Hvordan konvertere RST til MD
- Legg til din .RST-fil - slipp den i boksen over eller klikk for å bla gjennom.
- Konverter den til .MD i løpet av noen få sekunder.
- Last ned din nye .MD-fil.
Hva du kan forvente
- Overskrifter, punktlister, lenker og innebygd kode konverteres rent; RST-direktiver (
.. note::,.. code-block::) og roller (:ref:,:func:) utelates eller tilnærmes - gå gjennom hvert direktiv etter konvertering. - En
.. toctree::blir ikke bevart; du må gjenoppbygge innholdsfortegnelsen manuelt etter konvertering. - For å målrette mot en spesifikk Markdown-variant, legg til
-t gfm(GitHub Flavored Markdown) eller-t commonmarki Pandoc.
Ofte stilte spørsmål
Er konvertering fra RST til Markdown tapsfri?
Nei. Grunnleggende innhold - overskrifter, lister, lenker, innebygd kode - blir med over, men RST-direktiver og roller har ingen Markdown-ekvivalent og går tapt. Manuell opprydding er normalt.
Hva er hovedforskjellen mellom RST og Markdown?
Begge er markeringsspråk i ren tekst, men RST har et rikere system for direktiver og roller designet for strukturert dokumentasjon (Sphinx). Markdown er enklere og mer brukt for README-filer og generelle notater.
Hvordan konverterer jeg en hel mappe med RST-filer?
Pandoc håndterer én fil per kommando; på Linux eller macOS kan du bruke en løkke:
for f in *.rst; do pandoc "$f" -o "${f%.rst}.md"; done.Hvordan holder jeg Sphinx-dokumentasjonen fungerende etter konvertering til Markdown?
Bruk MyST Markdown i stedet for vanlig Markdown - MyST støtter RST-lignende direktiver og roller slik at ditt Sphinx-bygg fortsetter å fungere.
