Ajouter la source
Saisissez, collez ou ouvrez un document Markdown. Le contenu reste disponible pour les corrections.
Obtenez une base .rst modifiable. Les directives Sphinx, rôles et références propres à votre projet doivent être ajoutés ou vérifiés dans la chaîne cible.
Notes du projet
===============
Un document clair commence par une **structure précise**.
Points à contrôler
------------------
* Des titres faciles à suivre
* Des liens qui restent valides
* Des fichiers simples à modifier
Vérifiez l’aperçu rendu avant le téléchargement.
Travaillez à partir d’un document Markdown, puis contrôlez un document reStructuredText avant de l’utiliser ailleurs.
Saisissez, collez ou ouvrez un document Markdown. Le contenu reste disponible pour les corrections.
Comparez les titres, les listes, les liens, les tableaux et les caractères particuliers avec la source.
Générez un document reStructuredText, ouvrez le résultat dans son application cible et vérifiez les éléments importants.
La conversion conserve la structure utile lorsque les deux formats la représentent. Elle ne promet pas une reproduction visuelle à l’identique.
Préparer une version adaptée au canal de diffusion.
Partager le contenu avec une personne qui n’utilise pas le format source.
Conserver une version légère et modifiable pour la suite du travail.
La hiérarchie des titres et paragraphes reste lisible. Les listes, liens et blocs de code changent de syntaxe. Le résultat peut servir de base à une documentation Sphinx. Vérifiez néanmoins le résultat dans l’application cible.
Les formats n’offrent pas les mêmes fonctions. Les directives Sphinx ne sont pas déduites. Certaines tables ou extensions Markdown demandent une retouche.
Construisez la documentation cible et corrigez les avertissements. Conservez la source jusqu’à la fin de la comparaison.