Convertir a reStructuredText
Convierte 14 formatos de documento en reStructuredText listo para Sphinx. El escritor RST de Pandoc gestiona directivas, roles y tablas — ideal para proyectos de documentación Python.
Click to start converting
Go to Pandoc engine — reStructuredText output selected automatically
Supported input formats
| 格式 | 扩展名 | 说明 |
|---|---|---|
| Word (docx) | .docx | Encabezados, tablas, notas al pie, imágenes, control de cambios |
| LibreOffice (odt) | .odt | Estilos de párrafo, páginas maestras, multimedia incrustada |
| Libro electrónico (epub) | .epub | Estructura de capítulos, metadatos del libro, imágenes |
| HTML | .html | Encabezados, listas, tablas, enlaces — lector HTML genuino |
| LaTeX | .tex | Matemáticas, entornos, citas |
| reStructuredText | .rst | Directivas, roles, tablas |
| Org-mode | .org | Titulares, propiedades, cajones |
| CSV | .csv | Pandoc renderiza como tablas pipe GFM |
| TSV | .tsv | Separado por tabuladores, renderizado como tablas pipe |
| MediaWiki | .mediawiki | Plantillas, enlaces, tablas |
| DocBook | .docbook | Artículos, secciones, objetos multimedia |
| Esquemas OPML | .opml | Esquemas anidados → jerarquía de encabezados |
| Cuaderno Jupyter | .ipynb | Celdas de código, salidas, celdas markdown |
Cómo funciona la conversión
El escritor RST de Pandoc asigna el árbol del documento a las convenciones de reStructuredText: los niveles de encabezado se convierten en estilos de subrayado consistentes, las listas de viñetas se convierten en guiones, las listas de definición conservan su estructura, y las tablas se emiten en sintaxis grid o simple según su complejidad.
Como el escritor se dirige a RST estándar, la salida entra directamente en proyectos Sphinx — toctrees, directivas code-block y notas se procesan sin arreglos manuales. Esta es la ruta más rápida de una especificación de Word a una página de Read the Docs.
La conversión se ejecuta completamente en tu navegador vía WebAssembly. Nada se sube.
Problemas comunes y cómo solucionarlos
RST es más estricto que Markdown con los subrayados de encabezado, pero Pandoc los genera de forma consistente — si reestructuras los niveles de encabezado a mano después, mantén las longitudes de subrayado al menos tan largas como el texto del título.
El contenido de Word no lleva semántica de referencia cruzada, así que roles como :ref: o :doc: no se inventan para ti — añádelos después de la conversión. Los bloques de código pueden necesitar un lenguaje explícito tras la directiva code-block para que Pygments los resalte.
Las tablas de Word muy anchas pueden exceder la anchura de cuadrícula legible de RST; considera dividirlas o convertir la sección en una list-table después.
Quién usa esta página
Equipos Python que migran documentos de requisitos y diseños a Sphinx, mantenedores que mueven exportaciones de wiki a Read the Docs, y redactores técnicos que preparan reStructuredText para proyectos que se estandarizan en docutils en lugar de Markdown.
Preguntas frecuentes de convertir a RST
+¿Es la salida compatible con Sphinx?
Sí. El escritor RST de Pandoc produce reStructuredText estándar que Sphinx procesa directamente — directivas, roles y bloques de código funcionan.
+¿Puedo convertir documentos de Word a RST?
Sí. Suelta un .docx, selecciona salida reStructuredText y obtén archivos .rst listos para Sphinx. Encabezados, tablas y notas al pie se preservan.
+¿Por qué querría RST en lugar de Markdown?
RST admite directivas (.. note::, .. code-block::), roles (:ref:, :doc:) y tablas extendidas — funciones que Markdown no tiene. Es el estándar para documentación Python y científica.