Este conversor pasa RST a Markdown: convierte reStructuredText (Sphinx, docutils, README de PyPI) en GitHub Flavored Markdown con secciones, bloques de código, tablas grid y simples, admonitions, notas al pie y enlaces. Pega el texto .rst y copia el Markdown.
Última actualización:
Cómo funciona
Pega el RST
Pega un README.rst o una página de Sphinx, abre un archivo .rst o prueba con Cargar ejemplo.
Elige el estilo de Markdown
Admonitions como alertas de GitHub o como citas, viñeta, énfasis y delimitador de código.
Copia el Markdown
Úsalo en GitHub, MkDocs, Docusaurus o para migrar a MyST; revisa la vista previa.
Funciones
Niveles de sección según los adornos
Los niveles siguen el orden en que aparece por primera vez cada estilo de subrayado y línea superior, igual que lo decide docutils.
Todos los tipos de bloque
Directivas code-block, code y sourcecode, bloques literales tras ::, bloques doctest, bloques de líneas y citas con atribución.
Tablas
Las tablas grid, las tablas simples (con líneas de continuación) y las directivas list-table y csv-table se convierten en tablas Markdown.
Referencias resueltas
Destinos de hipervínculo con nombre y anónimos, URI incrustadas, sustituciones con imágenes y notas al pie numeradas y autonumeradas.
Límites y privacidad
Archivos de hasta 10 MB. Las entradas de más de 256 KB se convierten en un Web Worker. No se sube nada: la conversión ocurre en tu navegador, y Abrir desde URL descarga el archivo directamente desde la dirección que escribes. Más información en la página de privacidad.
Límites
Las directivas include y las referencias cruzadas de Sphinx necesitan el proyecto completo y no se resuelven. En las tablas con encabezado de varias filas, solo la primera fila queda como encabezado de Markdown. Las listas de campos se convierten en términos en negrita seguidos de su texto.
Preguntas frecuentes
¿Cómo convierto RST a Markdown sin pandoc?
Pega el reStructuredText aquí y copia el resultado; no hay que instalar nada.
¿Qué pasa con directivas de Sphinx como toctree?
toctree, autodoc e include necesitan el proyecto completo, así que se omiten con una advertencia que nombra cada una.
¿Se admiten las admonitions?
note, tip, important, warning, caution, danger, hint, seealso y la admonition genérica pasan a alertas de GitHub o a citas.
¿Y los roles como :ref: y :doc:?
Las referencias cruzadas se convierten en su texto; :code:, :math:, :sup: y :sub: mantienen su significado.
¿Cómo se convierte un README.rst para GitHub?
Pega el archivo, deja las admonitions como alertas de GitHub y copia el Markdown a un README.md.
¿Puedo convertir Markdown a RST?
Sí, con Markdown → RST, que está enlazado encima del resultado.