Come convertire RST in MD
- Aggiungi il tuo file .RST - trascinalo nel riquadro sopra o fai clic per sfogliare.
- Convertilo in .MD in pochi secondi.
- Scarica il tuo nuovo file .MD.
Cosa aspettarsi
- Intestazioni, elenchi puntati, link e codice inline si convertono in modo pulito; le direttive RST (
.. note::,.. code-block::) e i ruoli (:ref:,:func:) vengono rimossi o approssimati - revisiona ogni direttiva dopo la conversione. - Un
.. toctree::non viene preservato; è necessario ricostruire manualmente l'indice dopo la conversione. - Per puntare a una specifica variante di Markdown, passa
-t gfm(GitHub Flavored Markdown) o-t commonmarka Pandoc.
Domande frequenti
La conversione da RST a Markdown è senza perdita (lossless)?
No. Il contenuto di base - intestazioni, elenchi, link, codice inline - viene trasferito, ma le direttive e i ruoli RST non hanno un equivalente Markdown e vanno persi. La pulizia manuale è normale.
Qual è la differenza principale tra RST e Markdown?
Entrambi sono linguaggi di markup in testo semplice, ma RST ha un sistema di direttive e ruoli più ricco progettato per la documentazione strutturata (Sphinx). Markdown è più semplice e più ampiamente utilizzato per i README e le note generali.
Come posso convertire un'intera cartella di file RST?
Pandoc gestisce un file per comando; su Linux o macOS, usa un ciclo con
for f in *.rst; do pandoc "$f" -o "${f%.rst}.md"; done.Come posso mantenere funzionante la documentazione Sphinx dopo la conversione in Markdown?
Usa MyST Markdown invece del normale Markdown - MyST supporta direttive e ruoli in stile RST in modo che la tua build Sphinx continui a funzionare.
