Word à Confluence Markdown: Importer des documents dans votre wiki d'équipe

Confluence est l'un des wikis d'équipe les plus utilisés, et de nombreuses organisations ont des bibliothèques de documents Word qui appartiennent à Confluence. Convertir ces documents de manière propre est plus délicat qu'il n'y paraît Confluences Markdown le support a des bizarreries. Ce guide vous montre le plus fiable Word à Confluence le flux de travail.

Le Confluence prend-il en charge le Markdown ?

Confluence est partiellement pris en charge par Markdown, mais il dépend de la mise en œuvre:

• Confluence Nuage prend en charge la macro Markdown et peut rendre Markdown dans certains contextes, mais l'éditeur natif est son propre format
• Confluence Centre de données / serveur a également une macro Markdown
• Atlassian Rovo / Nouveau éditeur Les versions plus récentes ont amélioré le support de collage Markdown

La méthode la plus fiable dans toutes les versions est de convertir Word en Markdown avec WordToMD, puis collez le contenu Markdown en utilisant la fonction d'importation Confluences Markdown.

Méthode 1: coller Markdown par l'intermédiaire de l'éditeur Confluence

Les étapes

1. Convertissez votre document Word à WordToMD et cliquez sur Copy Markdown
2. Dans Confluence, ouvrez l'éditeur de page
3. Dans le menu Insérer (+ icône), sélectionnez Marquage ou Autres macros → Marquage
4. Choisissez Markdown comme langue
5. Coller le contenu Markdown
6. Cliquez sur Insérer

La macro Markup/Markdown rend le contenu en texte riche à l'intérieur de la page. Il ne convertit pas en blocs Confluence natifs, mais il rend les en-têtes, les tables et les listes correctement.

Méthode 2: Word Importer le fichier

Confluence Cloud dispose d'une fonction d'importation Word:

1. Créer une nouvelle page Confluence
2. Cliquez sur le menu ... → Importer Word Document
3. Sélectionnez votre fichier .docx

Cela fonctionne pour les documents simples mais a tendance à perdre la mise en forme complexe. La voie Markdown donne plus de contrôle.

Méthode 3: Conversion en HTML

Certaines équipes préfèrent HTML comme format intermédiaire car l'éditeur Confluence accepte HTML coller:

1. Convertissez votre Word doc en Markdown avec WordToMD
2. Convertir le Markdown en HTML à l'aide d'un outil en ligne ou marked library
3. Passez à l'éditeur source Confluence (Ctrl+Shift+D ou à partir de la barre d'outils)
4. Collez le HTML

Cette approche préserve une mise en forme plus complexe mais est plus d'étapes.

Compatibilité avec le formatage

Des tables de manutention

Word tables convertis à GFM syntaxe de tuyau via WordToMD. Confluence’s Markdown macro renders these correctly:

| Project | Owner | Status |
|---|---|---|
| Website redesign | Alice | In progress |
| API migration | Bob | Complete |

Pour des opérations de table plus complexes, voir Markdown Tableaux: un guide complet.

Blocs de code dans Confluence

Confluence possède sa propre macro de bloc de code qui offre des numéros de ligne et des numéros de syntaxe. Après avoir importé le contenu Markdown, vous voudrez peut-être remplacer les blocs de code de la macro Markdown par des macros natives Confluence Code Block pour une meilleure lisibilité:

1. Modifier la page
2. Trouver la section de code
3. Insérer une macro de bloc de code
4. Définir la langue pour mettre en évidence la syntaxe
5. Collez le code

Nom de l'établissement: Markdown Guide des blocs de code pour la syntaxe standard.

Atlassien Confluence et ADF

Confluence Cloud utilise nativement Format de document atlasique (ADF) un schéma JSON pour le contenu riche. La macro Markdown se trouve au-dessus de cela. Pour les importations programmatiques, le Confluence REST API accepte directement les ADF. Si vous construisez un pipeline automatisé, convertissez Word → Markdown → ADF en utilisant les bibliothèques disponibles.

Pour la plupart des équipes, le flux de travail manuel est plus simple et plus rapide.

Migrer une bibliothèque de documents

Si vous migrez des dizaines de documents Word vers Confluence:

1. Convertir tous les fichiers en utilisant WordToMD (ou lot avec Pandoc pour les grands volumes)
2. Créez un espace Confluence et planifiez la hiérarchie des pages
3. Importer des pages en sections, regrouper les documents connexes sous les pages mères
4. Ajouter des caractéristiques spécifiques à Confluence après l'importation: étiquettes, restrictions de page, @mentions

FAQ

Puis-je utiliser Markdown en natif dans Confluence sans la macro ? Dans certaines configurations de Confluence Cloud avec le nouvel éditeur, vous pouvez taper des raccourcis Markdown et ils se convertissent automatiquement (e.g., taper ## génère un H2). Mais pour coller des documents convertis, la macro Markdown est plus fiable.

Mon formatage d'en-tête est perdu après l'importation tout ressemble à du texte du corps. Cela signifie généralement que la macro Markdown n'est pas active. Le Markdown doit être dans un bloc de macro Markup/Markdown, non collé comme texte ordinaire dans l'éditeur standard.

Les tableaux sont affichés comme des caractères de pipe bruts. Le même problème le contenu doit être dans une macro Markdown, pas dans l'éditeur de texte standard.

Y a-t-il un moyen automatisé de synchroniser les documents Word avec les pages Confluence ? Oui outils comme Confluences Fonctionnalité Documents externes, Versions de défilement, ou des scripts personnalisés utilisant le Confluence REST API peuvent synchroniser automatiquement les fichiers Markdown aux pages.

Conclusion de l'enquête

Le plus propre . Word à Confluence Le flux de travail est: convertir avec WordToMD, puis importez via la macro Markdown. Pour les documents complexes ou les migrations en vrac, l'approche intermédiaire HTML ou l'automatisation REST API donne plus de contrôle. Quoi qu'il en soit, l'utilisation correcte des styles d'en-tête de Word avant la conversion assure que la hiérarchie de la page soit intacte.