Comment convertir du Markdown en balisage Wiki Confluence

Si vous écrivez en Markdown mais collaborez avec une équipe qui utilise Atlassian Confluence, vous avez probablement rencontré le décalage de format : Confluence Data Center et Server utilisent leur propre syntaxe de balisage wiki, qui ne ressemble en rien au Markdown.

Réécrire manuellement vos documents est fastidieux et source d’erreurs. md-to.com propose un convertisseur gratuit, basé sur le navigateur, qui transforme le Markdown en balisage wiki Confluence en temps réel.

Cet article détaille ce que l’outil supporte, comment l’utiliser et les points de vigilance.

---

Quelle syntaxe est supportée ?

Le convertisseur gère les éléments Markdown suivants et les mappe vers leurs équivalents Confluence :

Formatage du texte

Markdown	Sortie Confluence
**gras**	*gras*
*italique*	_italique_
~~barré~~	-barré-
`code en ligne`	{{code en ligne}}

Titres

Les # à ###### du Markdown sont mappés vers h1. à h6. dans Confluence.

## Titre de section

devient :

h2. Titre de section

Liens et images

• [Google](https://google.com) devient [Google|https://google.com]
• ![texte alt](https://example.com/img.png) devient !https://example.com/img.png|alt=texte alt!

Blocs de code

Les blocs de code délimités sont convertis en macros {code} de Confluence. L’identifiant de langage est conservé :

```javascript
function greet(name) {
  return "Hello, " + name;
}
```

devient :

{code:language=javascript}
function greet(name) {
  return "Hello, " + name;
}
{code}

Les blocs de code sans balise de langage omettent l’attribut :language=.

Tableaux

Les tableaux Markdown sont convertis avec || pour les cellules d’en-tête et | pour les cellules de données :

| Nom   | Âge |
|-------|-----|
| Alice | 30  |

devient :

||Nom||Âge||
|Alice|30|

Les caractères pipe à l’intérieur des cellules sont automatiquement échappés.

Listes

• Les listes non ordonnées utilisent *, avec ** pour les éléments imbriqués, *** pour les niveaux plus profonds, etc.
• Les listes ordonnées utilisent #, avec ## pour les éléments imbriqués.
• Les listes de tâches sont converties : - [x] devient (/) (fait) et - [ ] devient (x) (non fait).

Citations

Les citations sont encapsulées dans {quote}...{quote}. Les citations imbriquées sont aplaties en un seul bloc {quote}, car Confluence ne supporte pas les citations imbriquées.

Lignes horizontales

--- en Markdown devient ---- dans Confluence.

---

Comment l’utiliser

1. Collez votre Markdown dans l’éditeur à gauche sur md-to.com/fr/markdown-to-confluence.
2. Consultez la sortie à droite — elle se met à jour en temps réel.
3. Copiez ou téléchargez le balisage wiki Confluence via les boutons au-dessus du panneau de sortie.

L’éditeur synchronise le défilement entre l’entrée et la sortie, vous permettant de vérifier les longs documents sans perdre votre position.

---

Comment ça fonctionne

Le convertisseur est construit sur markdown-it, un parseur Markdown qui produit un flux de tokens (un arbre syntaxique abstrait). Au lieu d’utiliser des remplacements regex fragiles, l’outil parcourt l’arbre de tokens et rend chaque nœud dans le balisage Confluence correspondant.

Cette approche signifie :

• Les structures imbriquées (listes dans des listes, blocs de code dans des éléments de liste) sont gérées correctement.
• Les caractères spéciaux dans les liens, images et cellules de tableau sont échappés là où nécessaire.
• La sortie reste cohérente avec l’interprétation de markdown-it, évitant les surprises des cas limites.

Tout le traitement se fait localement dans votre navigateur. Aucune donnée n’est envoyée à un serveur.

---

Compatibilité et limites

Environnement cible : La sortie est conçue pour Confluence Data Center / Server, ou le flux d’insertion de balisage hérité dans Confluence Cloud. Le nouvel éditeur de Confluence Cloud n’accepte pas directement le balisage wiki.

Limites connues :

• Les citations imbriquées sont aplaties — le balisage wiki Confluence ne supporte pas les {quote} imbriqués.
• Le HTML brut dans le Markdown est ignoré (le parseur a le HTML désactivé).
• Les plugins avancés de markdown-it (notes de bas de page, listes de définitions, etc.) ne sont pas activés.

---

En résumé

Si vous devez transférer du contenu Markdown dans Confluence Data Center ou Server, ce convertisseur gère le mapping de syntaxe pour vous — titres, formatage, blocs de code, tableaux, listes et plus encore.

Essayez-le sur md-to.com/fr/markdown-to-confluence.

---

Ressources :

• Convertisseur Markdown vers Confluence de md-to.com