Cómo convertir RST a HTML
- Añada su archivo .RST: arrástrelo al cuadro de arriba o haga clic para buscarlo.
- Conviértalo a .HTML en pocos segundos.
- Descargue su nuevo archivo .HTML.
Qué esperar
- Las directivas específicas de Sphinx (
.. toctree::,:ref:,:doc:) solo se resuelven dentro de una compilación completa de Sphinx; procesar un proyecto de Sphinx a través derst2htmllas omite silenciosamente o genera errores. - Tanto
rst2htmlcomo Pandoc generan un HTML estructuralmente correcto pero visualmente sencillo (sin tema aplicado); añada su propio CSS o use Sphinx para un resultado pulido. - Los archivos RST pueden incrustar HTML puro y scripts a través de
.. raw:: html; solo convierta archivos.rstde fuentes en las que confíe.
Preguntas frecuentes
¿Por qué rst2html falla en mi proyecto de Sphinx?
Es probable que el archivo utilice directivas exclusivas de Sphinx como
toctree o automodule que Docutils no puede resolver sin el flujo de compilación completo de Sphinx. Ejecute sphinx-build -b html docs/ _build/html en su lugar.¿Qué herramienta produce el resultado con mejor apariencia?
Sphinx, porque aplica un tema HTML completo con navegación y búsqueda. El resultado de
rst2html y Pandoc es correcto pero visualmente minimalista.¿Puedo convertir HTML de nuevo a RST?
No de manera confiable: la conversión es unidireccional. Mantenga el archivo
.rst como su fuente de verdad y regenere el HTML cada vez que cambie.¿Cuál es la diferencia entre Docutils y Sphinx?
Docutils (
rst2html) procesa un solo archivo .rst de forma aislada. Sphinx se basa en Docutils y añade referencias entre archivos, una tabla de contenidos, soporte para extensiones y temas HTML completos para proyectos de documentación integrales.
