Confluence ne veut pas vous laisser partir. Atlassian stocke votre contenu dans un format XML propriétaire, ne propose aucun export Markdown et rend l’extraction en masse douloureuse. Si vous avez déjà essayé d’extraire du texte propre de Confluence, vous connaissez la frustration.

Ce guide couvre toutes les méthodes pour exporter des pages Confluence en Markdown --- de la page individuelle à l’espace entier.

Pourquoi exporter Confluence en Markdown ?

Les équipes quittent Confluence pour de nombreuses raisons :

Migration vers un nouvel outil --- passage à Notion, GitBook, Docusaurus, ou un générateur de site statique qui utilise Markdown
Archivage d’une base de connaissances --- préserver la documentation de l’équipe avant l’expiration d’une licence Atlassian
Construction d’une base de connaissances pour l’IA --- alimenter Claude, ChatGPT ou un LLM interne avec une documentation propre
Sauvegarde de documents critiques --- disposer d’une copie portable qui ne dépend pas des serveurs Atlassian
Sortir du verrouillage fournisseur --- posséder son contenu dans un format universel

Méthode 1 : Save (la plus rapide pour les pages individuelles)

Save est une extension Chrome qui convertit n’importe quelle page Confluence en Markdown propre en un seul clic.

Comment ça marche :

Ouvrez n’importe quelle page Confluence dans Chrome
Cliquez sur l’icône de l’extension Save
Un fichier .md se télécharge instantanément

Ce que vous obtenez :

Texte complet de la page avec la hiérarchie des titres
Tableaux formatés en tableaux Markdown
Blocs de code avec balises de langage
Panneaux d’information convertis en citations bloc
Sections développer/réduire (entièrement développées)
Métadonnées propres : titre de la page, nom de l’espace, date de dernière mise à jour
Liens internes et externes conservés

Ce qui est supprimé :

Macros Atlassian et formatage propriétaire
Navigation, barres latérales et menus
Artefacts de l’éditeur WYSIWYG
Styles en ligne et CSS

Idéal pour : Sauvegarder des pages individuelles ou de petits lots. Pour 5 à 50 pages, c’est la méthode la plus rapide.

Exemple de sortie

D’un runbook Confluence typique :

# Deployment Runbook --- Production API

**Space:** Engineering
**Last updated:** March 12, 2026

---

## Pre-Deployment Checklist

- [ ] All CI checks passing on `main`
- [ ] Database migrations reviewed and approved
- [ ] Feature flags configured for gradual rollout
- [ ] Rollback plan documented

## Deployment Steps

### 1. Create Release Branch

\`\`\`bash
git checkout -b release/v2.4.0 main
git push origin release/v2.4.0
\`\`\`

### 2. Run Database Migrations

\`\`\`sql
ALTER TABLE users ADD COLUMN preferences JSONB DEFAULT '{}';
CREATE INDEX idx_users_preferences ON users USING GIN (preferences);
\`\`\`

Méthode 2 : Export natif de Confluence (HTML, puis conversion)

Confluence peut exporter des pages en HTML. Vous pouvez ensuite convertir le HTML en Markdown avec un outil comme Pandoc.

Étapes :

Aller sur la page → menu … → Exporter en PDF/Word/HTML
Choisir l’export HTML
Convertir avec Pandoc : pandoc input.html -o output.md

Problèmes avec cette approche :

L’export HTML inclut le CSS d’Atlassian, des macros et des styles en ligne
Les tableaux cassent souvent lors de la conversion
Les blocs de code perdent leurs balises de langage
Les images font référence à des URLs Confluence qui peuvent casser par la suite
Les pages imbriquées nécessitent l’export de l’espace entier

Cette méthode fonctionne mais produit une sortie désordonnée qui nécessite un nettoyage manuel.

Méthode 3 : Export d’espace + conversion en masse

Pour exporter un espace Confluence entier :

Aller dans Paramètres de l’espace → Outils de contenu → Exporter
Choisir le format HTML
Télécharger l’archive ZIP
Utiliser un script pour convertir les fichiers HTML en Markdown en masse

Le problème : Les exports d’espace Confluence produisent du HTML profondément imbriqué avec des liens relatifs cassés, des éléments de navigation dupliqués et un balisage spécifique à Atlassian. Nettoyer tout ça de manière programmatique est un projet de week-end.

Méthode 4 : L’API REST Confluence

Pour un accès programmatique :

curl -u [email protected]:API_TOKEN \
  "https://your-domain.atlassian.net/wiki/rest/api/content/PAGE_ID?expand=body.storage" \
  | jq -r '.body.storage.value' > page.html

Cela vous donne le format de stockage brut (type XHTML). Il vous faudra ensuite :

Parser le format de stockage Atlassian
Gérer les macros, les intégrations et les éléments spéciaux
Convertir en Markdown
Répéter pour chaque page

Idéal pour : Les équipes d’ingénierie qui construisent un pipeline de migration. Trop complexe pour la plupart des cas d’usage.

Quelle méthode utiliser ?

Scénario	Meilleure méthode
Sauvegarder 1 à 50 pages rapidement	Extension Save --- un clic par page
Archiver un espace entier	Export d’espace + Pandoc --- en masse mais désordonné
Construire un pipeline de migration	API REST --- programmatique mais complexe
Sauvegarde rapide de documents clés	Extension Save --- sortie la plus propre
Alimenter des docs vers un LLM	Extension Save --- Markdown est natif pour les LLM

Pour la plupart des gens, Save est la réponse. Il produit le Markdown le plus propre sans aucune configuration, et gère automatiquement le formatage propriétaire de Confluence.

Rendre votre contenu Confluence utile

Une fois vos pages exportées en Markdown, vous pouvez :

Tout rechercher avec grep, VS Code ou Obsidian
L’alimenter à Claude ou ChatGPT pour des réponses instantanées sur votre documentation
Le versionner dans Git --- suivre les changements de vos docs comme du code
L’importer dans n’importe quel outil --- Notion, Obsidian, GitBook, Docusaurus, ou un générateur de site statique
Le conserver pour toujours --- les fichiers Markdown sont du texte brut. Ils seront lisibles dans 50 ans

Pour commencer

Installez Save et essayez-le sur une page Confluence maintenant. C’est gratuit pour démarrer, et vous verrez du Markdown propre en quelques secondes.

Quitter Confluence n’a pas à être douloureux. Save convertit n’importe quelle page en Markdown propre en un clic.