Comment convertir RST en MD
- Ajoutez votre fichier .RST - déposez-le dans la zone ci-dessus ou cliquez pour parcourir.
- Convertissez-le en .MD en quelques secondes.
- Téléchargez votre nouveau fichier .MD.
À quoi s'attendre
- Les titres, les listes à puces, les liens et le code en ligne se convertissent proprement ; les directives RST (
.. note::,.. code-block::) et les rôles (:ref:,:func:) sont supprimés ou approximés - vérifiez chaque directive après conversion. - Un
.. toctree::n'est pas préservé ; vous devez reconstruire la table des matières manuellement après la conversion. - Pour cibler une variante spécifique de Markdown, passez
-t gfm(GitHub Flavored Markdown) ou-t commonmarkà Pandoc.
Foire aux questions
La conversion de RST vers Markdown est-elle sans perte ?
Non. Le contenu de base - titres, listes, liens, code en ligne - est conservé, mais les directives et rôles RST n'ont pas d'équivalent Markdown et sont perdus. Un nettoyage manuel est normal.
Quelle est la principale différence entre RST et Markdown ?
Les deux sont des langages de balisage en texte brut, mais RST possède un système de directives et de rôles plus riche conçu pour la documentation structurée (Sphinx). Markdown est plus simple et plus utilisé pour les fichiers README et les notes générales.
Comment convertir un dossier entier de fichiers RST ?
Pandoc traite un fichier par commande ; sur Linux ou macOS, utilisez une boucle avec
for f in *.rst; do pandoc "$f" -o "${f%.rst}.md"; done.Comment garder mes documents Sphinx fonctionnels après conversion en Markdown ?
Utilisez MyST Markdown au lieu du Markdown classique - MyST prend en charge les directives et rôles de style RST afin que votre compilation Sphinx continue de fonctionner.
