Convertidor online gratuito de MMD a RST

Los proyectos que utilizan Sphinx, Docutils u otro sistema de documentación basado en reStructuredText requieren un archivo .rst en lugar del código fuente de MultiMarkdown. La conversión conserva los encabezados, las listas, los enlaces, los bloques de código y otras estructuras compatibles en un formato de texto plano editable.

Qué es el formato MMD

MMD normalmente significa MultiMarkdown, un formato Markdown extendido almacenado como un archivo de texto plano .mmd. Añade funciones como metadata, tablas, notas al pie, citas, listas de definiciones y referencias cruzadas al Markdown estándar.

Los archivos MultiMarkdown se crean con las herramientas de línea de comandos de MultiMarkdown y con editores Markdown compatibles con la sintaxis de MultiMarkdown. Puede encontrarlos en proyectos de redacción, repositorios de documentación técnica y archivos de código fuente preparados para su conversión a HTML, PDF u otros formatos de documento.

Qué es el formato RST

RST, o reStructuredText, es un formato estructurado de marcado de texto plano utilizado por Docutils, Sphinx, la documentación de Python y los generadores de documentación. Sus marcadores de sección explícitos, directivas, roles, etiquetas y listas de campos lo hacen adecuado para proyectos de documentación grandes y compilaciones automatizadas.

RST es útil cuando el sistema de destino espera archivos que terminen en .rst, especialmente un proyecto de Sphinx. También admite admonitions, directivas de API, referencias internas, tablas, bloques de código literal y campos de metadata, aunque algunas funciones de MultiMarkdown requieren ajustes manuales después de la conversión.

Cómo convertir realmente MMD a RST

Uso de Pandoc

Pandoc es la opción de escritorio o de línea de comandos más práctica para una conversión estructurada. Instale una versión actual de Pandoc, abra un terminal en la carpeta que contiene el archivo de código fuente y ejecute:

pandoc input.mmd -f markdown_mmd -t rst -o output.rst

El reader markdown_mmd indica a Pandoc que interprete el código fuente como MultiMarkdown, mientras que rst selecciona la salida en reStructuredText. Sustituya input.mmd y output.rst por los nombres de archivo reales.

Para un documento que utiliza la sintaxis Markdown estándar en lugar de extensiones específicas de MultiMarkdown, esta alternativa suele ser suficiente:

pandoc input.mmd -f markdown -t rst -o output.rst

Abra el archivo resultante en un editor de texto, compruebe los subrayados de sección y las directivas generados y, después, compílelo con Sphinx o Docutils. En un proyecto de Sphinx, coloque output.rst en el directorio de código fuente de la documentación y ejecute el comando de compilación habitual del proyecto.

Uso del convertidor en línea

Puede convertir el archivo gratis en el sitio web 101convert.com sin instalar software: seleccione el archivo MMD, elija RST como formato de salida, inicie la conversión y descargue el archivo .rst generado.

Limitaciones de calidad y compatibilidad

• La metadata de MultiMarkdown puede convertirse en sintaxis de listas de campos de RST, párrafos normales o comentarios del documento, según el campo y la versión de Pandoc; compruebe manualmente el título, el autor, la fecha y el resto de la metadata.
• Los encabezados, el énfasis, los enlaces, las imágenes, las listas numeradas, los bloques de código delimitados y muchas tablas suelen convertirse correctamente, pero RST requiere estilos de subrayado de sección únicos y una indentación más estricta.
• Las citas de MultiMarkdown, la transclusión, los atributos especiales y las extensiones personalizadas pueden no tener un equivalente directo en RST. Pandoc puede conservar el material no compatible como texto sin formato, pero no puede reproducir comportamientos que RST o el builder de destino no implementen.
• Compruebe las rutas de las imágenes, los destinos de los enlaces, las anclas, las notas al pie y los caracteres de escape después de la conversión. Sphinx puede requerir etiquetas explícitas como .. _label: y directivas como .. code-block:: python para funciones que eran implícitas en el código fuente MMD.