Convertir en reStructuredText
Transformez 14 formats de documents en reStructuredText prêt pour Sphinx. Le scripteur RST de Pandoc gère les directives, rôles et tableaux — idéal pour les projets de documentation Python.
Click to start converting
Go to Pandoc engine — reStructuredText output selected automatically
Supported input formats
| 格式 | 扩展名 | 说明 |
|---|---|---|
| Word (docx) | .docx | Titres, tableaux, notes de bas de page, images, suivi des modifications |
| LibreOffice (odt) | .odt | Styles de paragraphe, pages maîtresses, médias intégrés |
| Livre numérique (epub) | .epub | Structure des chapitres, métadonnées du livre, images |
| HTML | .html | Titres, listes, tableaux, liens — vrai lecteur HTML |
| LaTeX | .tex | Maths, environnements, citations |
| reStructuredText | .rst | Directives, rôles, tableaux |
| Org-mode | .org | Titres, propriétés, drawers |
| CSV | .csv | Pandoc rend en tableaux GFM pipes |
| TSV | .tsv | Séparé par tabulations, rendu en tableaux pipes |
| MediaWiki | .mediawiki | Modèles, liens, tableaux |
| DocBook | .docbook | Articles, sections, objets média |
| Plans OPML | .opml | Plans imbriqués → hiérarchie de titres |
| Carnet Jupyter | .ipynb | Cellules de code, sorties, cellules markdown |
Comment fonctionne la conversion
Le scripteur RST de Pandoc mappe l'arbre du document aux conventions reStructuredText : les niveaux de titre deviennent des styles de soulignement cohérents, les listes à puces deviennent des tirets, les listes de définition conservent leur structure, et les tableaux sont émis en syntaxe grid ou simple selon leur complexité.
Comme le scripteur cible le RST standard, la sortie se drop directement dans des projets Sphinx — les toctrees, les directives code-block et les notes se traitent toutes sans correction manuelle. C'est le chemin le plus rapide d'une spécification Word à une page Read the Docs.
La conversion s'exécute entièrement dans votre navigateur via WebAssembly. Rien n'est envoyé.
Problèmes courants et comment les résoudre
Le RST est plus strict que le Markdown sur les soulignements de titre, mais Pandoc les génère de façon cohérente — si vous restructurez les niveaux de titre à la main ensuite, gardez les longueurs de soulignement au moins aussi longues que le texte du titre.
Le contenu Word ne porte pas de sémantique de renvoi, donc les rôles comme :ref: ou :doc: ne sont pas inventés pour vous — ajoutez-les après la conversion. Les blocs de code peuvent avoir besoin d'un langage explicite après la directive code-block pour que Pygments les mette en surbrillance.
Les tableaux Word très larges peuvent dépasser la largeur de grille lisible du RST ; envisagez de les scinder ou de convertir la section en list-table ensuite.
Qui utilise cette page
Des équipes Python qui migrent des documents d'exigences et des docs de design vers Sphinx, des mainteneurs qui déplacent des exports wiki vers Read the Docs, et des rédacteurs techniques qui préparent du reStructuredText pour des projets qui standardisent sur docutils plutôt que Markdown.
FAQ Convertir en RST
+La sortie est-elle compatible avec Sphinx ?
Oui. Le scripteur RST de Pandoc produit du reStructuredText standard que Sphinx traite directement — directives, rôles et blocs de code fonctionnent tous.
+Puis-je convertir des documents Word en RST ?
Oui. Déposez un .docx, sélectionnez la sortie reStructuredText, et obtenez des fichiers .rst prêts pour Sphinx. Titres, tableaux et notes de bas de page sont préservés.
+Pourquoi vouloir du RST plutôt que du Markdown ?
Le RST prend en charge les directives (.. note::, .. code-block::), les rôles (:ref:, :doc:) et les tableaux étendus — des fonctionnalités que Markdown n'a pas. C'est le standard pour la documentation Python et scientifique.