Añade el Markdown
Abre o pega el documento y corrige la jerarquía de secciones.
Convertir Markdown a reStructuredText
Pasa documentación Markdown a reStructuredText (RST) para incorporarla a proyectos Sphinx o ecosistemas Python. La conversión cubre la sintaxis común; las directivas y roles avanzados se añaden después.
Entrada Markdown
247 caracteres
Vista previa de RST
Notas del proyecto
==================
Un documento claro empieza con una **buena estructura**.
Puntos importantes
------------------
* Encabezados fáciles de leer
* Enlaces que siguen funcionando
* Archivos sencillos de reutilizar
Revisa la vista previa antes de descargar.
Los archivos se procesan en esta pestaña del navegador.
Cómo convertir Markdown a RST
Comprueba el archivo con el constructor Sphinx del proyecto, porque los avisos de la compilación ayudan a detectar referencias incorrectas.
Revisa la conversión
Comprueba títulos subrayados, listas, enlaces, código y tablas.
Valida con Sphinx
Descarga el .rst, añádelo al proyecto y resuelve advertencias o referencias propias.
Documentación Python
Una fuente RST editable para continuar en Sphinx
La herramienta cambia la sintaxis estructural y conserva el texto como fuente versionable.
Secciones y listasConvierte la jerarquía y los bloques comunes al estilo de reStructuredText.
CódigoPrepara bloques literales o de código que después pueden completarse con directivas.
Enlaces legiblesAdapta referencias simples sin ocultar la URL o el texto del enlace.
Sphinx y Python
Migra documentación sin reescribir cada sección
Documentación de librerías
Convierte guías Markdown antes de integrarlas en la estructura de Sphinx.
Proyectos heredados
Adapta READMEs y notas a repositorios que estandarizan RST.
Publicación técnica
Prepara una base para añadir roles, referencias cruzadas e índices.
Preguntas frecuentes
¿Qué extensión usa reStructuredText?
Habitualmente .rst. Es el formato de fuente que utiliza Sphinx en muchos proyectos Python.
¿La conversión crea directivas Sphinx?
No. Transforma la sintaxis común; las directivas específicas dependen del proyecto y se añaden manualmente.
¿Puedo convertir un README?
Sí, como punto de partida. Revisa después badges, HTML incrustado y extensiones propias de la plataforma.