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

Texto convertido
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.

01

Añade el Markdown

Abre o pega el documento y corrige la jerarquía de secciones.

02

Revisa la conversión

Comprueba títulos subrayados, listas, enlaces, código y tablas.

03

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

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.