Este conversor sirve para convertir Markdown a RST (reStructuredText) para Sphinx, Read the Docs y PyPI: encabezados subrayados, directivas code-block, tablas grid, admoniciones y notas al pie. Pega un README.md y copia el .rst.
Última actualización:
Cómo funciona
Pega tu Markdown
Pega un README o una página de documentación, abre un archivo .md o usa Cargar ejemplo.
Elige las convenciones
Ajusta Subrayado de encabezados, Bloques de código, Tablas y Enlaces según tu proyecto.
Usa el .rst
Descarga README.rst o pega el texto en tu proyecto de Sphinx.
Funciones
Estructura de secciones válida
RST deduce los niveles por el orden de los estilos de subrayado, así que los niveles de Markdown que se saltan se compactan para evitar «Title level inconsistent».
Directivas, no trucos
El código pasa a .. code-block:: python, las notas a .. note:: o .. warning:: y las fórmulas a .. math::.
Tres estilos de tabla
Tablas grid, tablas simples o la directiva list-table, que es la más fácil de editar.
Reglas del marcado en línea resueltas
Se insertan espacios escapados donde RST necesita espacio alrededor de **negrita** o `enlaces`__.
Límites y privacidad
Archivos de hasta 10 MB. Las entradas de más de 256 KB se convierten en un Web Worker, así que la página sigue respondiendo. No se sube nada: la conversión se hace en tu navegador y Abrir desde URL descarga el archivo directamente desde la dirección que escribas. Más información en la página de privacidad.
Diferencias que conviene tener en cuenta
reStructuredText no tiene tachado ni subrayado: ese texto queda sin formato. Los saltos de línea forzados se convierten en bloques de líneas (líneas con |). Una transición (––) no puede abrir ni cerrar un documento, así que en esas posiciones se descarta. Las tablas grid y simples no tienen alineación de columnas.
Preguntas frecuentes
¿Cómo convierto README.md a README.rst?
Abre aquí el README.md y descarga el resultado como README.rst. Revisa las advertencias para ver lo que RST no puede expresar.
¿PyPI todavía necesita RST?
No, PyPI también muestra Markdown, pero los proyectos de Sphinx y muchas herramientas antiguas esperan reStructuredText.
¿Por qué se pierde la negrita dentro de un enlace?
reStructuredText no permite anidar marcado en línea. Se conserva el texto del enlace y el formato interior se descarta con una advertencia.
¿Cómo se escriben las imágenes dentro del texto?
Las imágenes en línea usan sustituciones: |nombre| en el texto y una definición .. |nombre| image:: al final.
¿Puedo pasar RST a Markdown?
Sí, con RST → Markdown, enlazado sobre el resultado.