Guide d'édition

Comment nettoyer du Markdown converti

Le Markdown converti est un brouillon assemblé à partir d'indices structurels d'un autre format. Travaillez par passes : supprimez le bruit d'extraction, réparez le plan, normalisez la syntaxe des blocs, vérifiez les références et ne peaufinez la prose qu'ensuite.

10 minutes de lecture

Préservez la conversion brute avant d'éditer

Conservez le résultat converti comme un document à part et gardez le fichier source jusqu'à la fin de la relecture. Cela vous offre une référence lorsqu'un texte semble manquant ou mal ordonné et évite qu'un brouillon non enregistré sans rapport soit écrasé.

Utilisez l'annulation après les actions de nettoyage automatisé et effectuez une catégorie de modification à la fois. Une réécriture large peut supprimer accidentellement un espacement volontaire dans le code ou modifier un emboîtement de listes déjà correct.

Supprimez le bruit d'extraction

Les en-têtes de PDF, numéros de page, pieds de page répétés, étiquettes de diapositives, lignes de tableau vides et lignes vides dupliquées n'apportent souvent aucun sens. Recherchez les fragments répétés et supprimez-les de manière cohérente, en prenant soin de ne pas effacer une expression qui fait aussi partie du vrai contenu.

  • Réduisez les suites de trois lignes vides ou plus hors des blocs de code.
  • Rejoignez les mots coupés uniquement par une césure de fin de ligne du PDF.
  • Supprimez la navigation ou le texte juridique type répété sur chaque page.
  • Supprimez les titres vides et les éléments de liste vides.

Reconstruisez un plan de titres logique

Utilisez un seul H1 pour le titre du document. Les sections principales utilisent généralement H2, les sous-sections H3, et ainsi de suite. Ne sautez pas de niveaux uniquement pour obtenir un style visuel plus petit ; la présentation appartient au moteur de rendu.

Les PDF convertis peuvent marquer les lignes en gras comme des titres de manière trop agressive, tandis que les documents Word avec mise en forme manuelle peuvent ne pas les marquer du tout. Lisez le plan comme une table des matières et ajustez les niveaux en fonction du sens.

Avant et aprèsMarkdown
Before:
# Deployment
#### Prerequisites
## Linux

After:
# Deployment
## Prerequisites
### Linux

Normalisez les listes et l'espacement

Utilisez un style de marqueur unique pour les éléments non ordonnés et une indentation cohérente pour l'imbrication. Gardez une ligne vide avant et après une liste, mais évitez les lignes vides entre chaque élément court, sauf si chaque élément contient plusieurs paragraphes.

Un convertisseur peut prendre des titres numérotés ou des cellules de tableau pour des éléments de liste. Confirmez que la numérotation ordonnée porte du sens plutôt que de refléter une étiquette de page source.

Simplifiez les tableaux pour les écrans étroits et la lisibilité de la source

Vérifiez que chaque ligne a le même nombre de cellules et que les barres verticales dans le contenu sont échappées. Raccourcissez les en-têtes verbeux, déplacez les longues explications sous le tableau et séparez les groupes de colonnes sans rapport.

Les cellules fusionnées, les tableaux imbriqués, les graphiques et les formules de feuille de calcul n'ont pas d'équivalent fiable en tableau Markdown. Remplacez-les par une liste, plusieurs petits tableaux, un résumé textuel ou un lien vers des données source maintenues.

Vérifiez les liens, les images et le code

Les liens relatifs hérités de HTML ou d'EPUB dépendent de leur emplacement d'origine. L'extraction PDF peut couper les URL, et les documents Office peuvent contenir un texte affiché dont la cible a changé. Ouvrez chaque lien important dans la destination finale.

Ajoutez un texte alternatif descriptif aux images conservées. Confirmez que le code délimité a le bon langage et que les caractères spéciaux n'ont pas été transformés typographiquement. N'exécutez jamais de commandes copiées avant de les avoir relues comme contenu non fiable.

Terminez par le sens, pas l'apparence

Comparez noms, dates, quantités, code et décisions avec la source. Réécrivez les phrases qui dépendaient de la position sur la page, des visuels de diapositives ou des couleurs de feuille de calcul. Prévisualisez ensuite en largeur bureau et étroite, téléchargez le fichier .md et validez-le dans le système de publication.

Une conversion propre doit se lire naturellement comme un document rédigé en Markdown, même lorsque l'original reste l'enregistrement faisant autorité.

Nettoyez la prochaine conversion dans un seul espace de travail

Ouvrez un brouillon converti, comparez la source et l'aperçu, puis copiez ou téléchargez le Markdown relu.

Convertir un fichier pris en charge