Cómo convertir RST a MD
- Añada su archivo .RST: arrástrelo al cuadro de arriba o haga clic para buscarlo.
- Conviértalo a .MD en pocos segundos.
- Descargue su nuevo archivo .MD.
Qué esperar
- Los encabezados, listas de viñetas, enlaces y código en línea se convierten limpiamente; las directivas de RST (
.. note::,.. code-block::) y los roles (:ref:,:func:) se eliminan o aproximan - revisa cada directiva después de la conversión. - Un
.. toctree::no se conserva; debes reconstruir la tabla de contenidos manualmente después de la conversión. - Para apuntar a una variante específica de Markdown, pasa
-t gfm(GitHub Flavored Markdown) o-t commonmarka Pandoc.
Preguntas frecuentes
¿La conversión de RST a Markdown es sin pérdidas?
No. El contenido básico (encabezados, listas, enlaces, código en línea) se transfiere, pero las directivas y roles de RST no tienen equivalente en Markdown y se pierden. La limpieza manual es normal.
¿Cuál es la principal diferencia entre RST y Markdown?
Ambos son lenguajes de marcado de texto plano, pero RST tiene un sistema de directivas y roles más rico diseñado para documentación estructurada (Sphinx). Markdown es más simple y se usa más ampliamente para archivos README y notas generales.
¿Cómo convierto una carpeta entera de archivos RST?
Pandoc maneja un archivo por comando; en Linux o macOS, usa un bucle con
for f in *.rst; do pandoc "$f" -o "${f%.rst}.md"; done.¿Cómo mantengo funcionando la documentación de Sphinx tras convertir a Markdown?
Usa MyST Markdown en lugar de Markdown convencional - MyST admite directivas y roles al estilo RST para que tu compilación de Sphinx siga funcionando.
