Word à Markdown Guide de mise en forme: préserver chaque style

Le formatage est l'endroit où la plupart des conversions Word-to-Markdown vont mal. Le texte en gras s'affiche comme texte ordinaire. Les tables s'effondrent. Les titres deviennent des paragraphes sans style. Ce guide explique exactement ce qui se passe pendant Word vers Markdown la conversion et la façon de contrôler la sortie.

Comprendre le processus de conversion

Lorsque vous convertissez un document Word en Markdown, deux choses se produisent:

1. Il s'agit d'un projet de loi. mammoth.js analyse le Word XML et cartographie chaque élément à HTML
2. Il s'agit d'un projet de loi qui a été approuvé par le Parlement européen et le Parlement européen. Turndown convertit la syntaxe HTML en Markdown

La deuxième étape est sans perte si le HTML est propre. La première étape est où la complexité de la mise en forme est importante Words styles doivent être mappés à des équivalents HTML connus.

Utilisation Convertisseur de WordToMDs pour voir exactement comment votre document se convertit en temps réel.

Styles d'en-tête

La décision de formatage la plus importante dans Word est d'utiliser des styles d'en-tête intégrés.

Erreur courante: Formatter manuellement le texte en gros et en gras au lieu d'appliquer un style de titre. Cela ressemble à un en-tête dans Word mais convertit en texte en gras dans Markdown, pas ##.

Pour la référence complète aux rubriques, voir Markdown Guide des rubriques.

L'accent mis sur le texte

Le soulignement et le soulignement n'ont pas d'équivalent Markdown dans la syntaxe standard. Après conversion, utilisez HTML <u> tags ou classes CSS personnalisées si votre plateforme de publication les prend en charge.

Liste de produits

Word's la mise en forme automatique de la liste convertit proprement:

- Bullet item one
- Bullet item two
  - Nested bullet (indent 2 spaces)

1. First item
2. Second item
   1. Nested numbered item

Ce qui brise les listes: Des tirets ou des chiffres tapés manuellement qui ne sont pas des éléments de liste Word réels. Ils ressemblent à des listes visuellement mais Word les traite comme des paragraphes de texte ordinaire. La correction: sélectionnez-les dans Word et appliquez le style Bullet de liste ou Numéro de liste.

Les tableaux

Les tableaux standard sont convertis en GitHub Aromatisé Markdown syntaxe du tableau:

| Column 1 | Column 2 | Column 3 |
|---|---|---|
| Cell A | Cell B | Cell C |
| Cell D | Cell E | Cell F |

Ce qui casse les tables:

• Cellules fusionnées la cellule couvrant plusieurs colonnes ou lignes sera effondrée
• Contenu de cellules multilinéaires Les ruptures de lignes à l'intérieur des cellules sont éliminées
• Tables imbriquées la table intérieure est aplatie en texte ordinaire

Pour une ventilation complète, voir Markdown Tableaux: un guide complet.

Code et texte préformaté

Texte formaté avec une police monospace (Courier New, Consolas) dans Word maps au code en ligne:

Use `console.log()` to debug.

Pour les blocs de code clôturés avec mise en évidence de la syntaxe, appliquez Words Code style de paragraphe si votre modèle en possède un, ou ajouter manuellement la triple clôture à backtick après la conversion. Voir aussi: Markdown Guide des blocs de code pour la syntaxe complète.

Les liens hypertexte

Word les hyperliens convertis parfaitement:

Visit [WordToMD](https://wordtomd.org) for instant conversion.

Le texte du lien et l'URL sont conservés. Les signets (liens internes au sein du même document) peuvent ne pas être convertis si la cible n'existe pas dans Markdown.

Des images

Les images sont les endroits où la conversion Word-to-Markdown est systématiquement insuffisante. mammoth.js peut extraire des images intégrées en tant qu'URI de données base64, mais le comportement par défaut est de noter leur présence dans les notes de conversion. Après conversion:

1. Exporter des images à partir de Word: Fichier → Enregistrer sous forme de page Web (HTML)
2. Faites référence à ces données dans Markdown: ![Alt text](path/to/image.png)

Caractères et symboles spéciaux

Word insère souvent automatiquement des caractères Unicode spéciaux:

• Les devis intelligents ("...") → préservées sous forme de caractères Unicode
• Je vous en prie .—) → conservé
• Espace non cassant → converti en espace régulier
• Symbole du droit d'auteur (©) → conservé

Si vous avez besoin d'une sortie ASCII uniquement, faites une recherche-et-remplacer dans votre éditeur de texte après la conversion.

Des styles personnalisés

Si votre document Word utilise des styles de paragraphe personnalisés (comme Callout ou Warning), mammoth.js les enregistre comme notes de conversion. Vous verrez des messages comme Unrecognized paragraph style: Callout. WordToMD filtre par défaut ces messages d'information.

Pour gérer les styles personnalisés, vous aurez besoin d'une configuration Pandoc locale avec un filtre personnalisé voir Pandoc Word à Markdown pour cette approche.

Liste de contrôle de mise en forme avant de convertir

Appliquez cette liste de contrôle à votre document Word avant de convertir:

• Toutes les rubriques utilisent des styles intégrés de Word (pas de mise en forme manuelle)
• Les listes sont créées avec les outils de liste Words (pas de tirets/numéros tapés)
• Les tableaux sont des grilles simples (aucune cellule fusionnée)
• Le code utilise une police monospace
• Les hyperliens sont de véritables hyperliens (pas seulement du texte souligné en bleu)

FAQ

Pourquoi mes en-têtes sont convertis en texte en gras ? Vous avez appliqué la mise en forme manuelle en gras + taille de police au lieu du style de l'en-tête. Dans Word, cliquez sur le paragraphe et regardez le panneau des styles il devrait indiquer Titre 1 non Normal.

Ma liste numérotée a recommencé à 1 au mauvais endroit comment puis-je la réparer ? Définir la continuation de la liste dans Word: cliquez avec le bouton droit sur la liste → Continuer la numérotation. Ou éditez le Markdown directement après la conversion.

L'alignement de la table semble mal dans Markdown. Qu'est ce qui s'est passé ? GFM utilisation des tableaux |---| pour les séparateurs d'alignement. WordToMD les génère automatiquement. Si le rendu semble décalé, vérifiez qu'aucune cellule ne comporte des caractères de pipe (|) dans leur contenu les échapper en tant que \|.

Conclusion de l'enquête

Je me nettoie . Word à Markdown mise en forme Il s'agit principalement d'utiliser Word correctement. Appliquer des styles d'en-tête intégrés, utiliser les outils de liste et de table Words, et vous obtiendrez une sortie presque parfaite du Convertisseur WordToMD. For edge cases — custom styles, complex tables, images — the tips above will get you the rest of the way there.