← Terug naar blog

Hoe Confluence-pagina's Exporteren naar Markdown (Gids 2026)

· Save Team
confluencemarkdowndocumentationenterprisemigration

Confluence wil niet dat je vertrekt. Atlassian slaat je inhoud op in een eigen XML-formaat, biedt geen Markdown-export en maakt bulk-extractie pijnlijk. Als je ooit schone tekst uit Confluence hebt proberen te halen, ken je de frustratie.

Deze gids behandelt elke methode om Confluence-pagina’s naar Markdown te exporteren --- van losse pagina’s tot hele spaces.

Waarom Confluence Exporteren naar Markdown?

Teams verlaten Confluence om veel redenen:

  • Migreren naar een nieuw tool --- overstappen naar Notion, GitBook, Docusaurus of een statische sitegenerator die Markdown verwacht
  • Een kennisbase archiveren --- teamdocumentatie bewaren voordat een Atlassian-licentie verloopt
  • Een AI-kennisbase bouwen --- schone documentatie voeden aan Claude, ChatGPT of een interne LLM
  • Kritieke documenten back-uppen --- een draagbare kopie hebben die niet afhankelijk is van Atlassian’s servers
  • Vendor lock-in ontsnappen --- je inhoud bezitten in een universeel formaat

Methode 1: Save (Snelst voor Individuele Pagina’s)

Save is een Chrome-extensie die elke Confluence-pagina met één klik converteert naar schone Markdown.

Hoe het werkt:

  1. Open een Confluence-pagina in Chrome
  2. Klik op het Save-extensie-icoon
  3. Een .md-bestand wordt onmiddellijk gedownload

Wat je krijgt:

  • Volledige paginatekst met koppenstructuur
  • Tabellen opgemaakt als Markdown-tabellen
  • Codeblokken met taaltags
  • Infopanelen omgezet naar blokcitaten
  • Uitvouw-/samenvouwsecties (volledig uitgevouwen)
  • Schone metadata: paginatitel, spacenaam, datum van laatste update
  • Interne en externe links behouden

Wat verwijderd wordt:

  • Atlassian-macro’s en eigen opmaak
  • Navigatichroom, zijbalken en menu’s
  • WYSIWYG-editorartefacten
  • Inline stijlen en CSS

Het beste voor: Individuele pagina’s of kleine batches opslaan. Als je 5-50 pagina’s nodig hebt, is dit de snelste methode.

Voorbeelduitvoer

Van een typisch Confluence runbook:

# Deployment Runbook --- Productie API

**Space:** Engineering
**Laatste update:** 12 maart 2026

---

## Pre-Deployment Checklist

- [ ] Alle CI-checks geslaagd op `main`
- [ ] Databasemigraties beoordeeld en goedgekeurd
- [ ] Feature flags geconfigureerd voor geleidelijke uitrol
- [ ] Rollback-plan gedocumenteerd

## Deployment Stappen

### 1. Maak Release-branch

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

### 2. Voer Databasemigraties Uit

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

Methode 2: Confluence’s Ingebouwde Export (HTML, Dan Converteren)

Confluence kan pagina’s exporteren als HTML. Je kunt de HTML vervolgens converteren naar Markdown met een tool zoals Pandoc.

Stappen:

  1. Ga naar de pagina → …-menu → Exporteren naar PDF/Word/HTML
  2. Kies HTML-export
  3. Converteer met Pandoc: pandoc input.html -o output.md

Problemen met deze aanpak:

  • HTML-export bevat Atlassian’s CSS, macro’s en inline stijlen
  • Tabellen breken vaak tijdens conversie
  • Codeblokken verliezen taaltags
  • Afbeeldingen verwijzen naar Confluence-URL’s die later kunnen breken
  • Geneste pagina’s vereisen het exporteren van de hele space

Deze methode werkt maar produceert rommelige uitvoer die handmatige opschoning vereist.

Methode 3: Space-export + Bulkconversie

Voor het exporteren van een volledige Confluence-space:

  1. Ga naar Space-instellingen → Inhoudstools → Exporteren
  2. Kies HTML-formaat
  3. Download het ZIP-archief
  4. Gebruik een script om HTML-bestanden in bulk naar Markdown te converteren

Het probleem: Confluence space-exports produceren diep geneste HTML met gebroken relatieve links, dubbele navigatie-elementen en Atlassian-specifieke opmaak. Dit programmatisch opschonen is een weekendproject.

Methode 4: Confluence REST API

Voor programmatische toegang:

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

Dit geeft je het ruwe opslagformaat (XHTML-achtig). Je zult moeten:

  1. Het Atlassian-opslagformaat parsen
  2. Macro’s, embeds en speciale elementen verwerken
  3. Converteren naar Markdown
  4. Herhalen voor elke pagina

Het beste voor: Engineeringteams die een migratiepipeline bouwen. Overkill voor de meeste use cases.

Welke Methode Moet Je Gebruiken?

ScenarioBeste Methode
Snel 1-50 pagina’s opslaanSave-extensie --- één klik per pagina
Een hele space archiverenSpace-export + Pandoc --- bulk maar rommelig
Een migratiepipeline bouwenREST API --- programmatisch maar complex
Snelle back-up van sleuteldocumentenSave-extensie --- schoonste uitvoer
Documenten voeden aan een LLMSave-extensie --- Markdown is LLM-native

Voor de meeste mensen is Save het antwoord. Het produceert de schoonste Markdown zonder setup, en het verwerkt Confluence’s eigen opmaak automatisch.

Je Confluence-inhoud Nuttig Maken

Zodra je je pagina’s hebt geëxporteerd naar Markdown, kun je:

  • Alles doorzoeken met grep, VS Code of Obsidian
  • Het voeden aan Claude of ChatGPT voor directe antwoorden over je documentatie
  • Versiebeheer toepassen in Git --- wijzigingen in je documenten bijhouden zoals code
  • Importeren in elk tool --- Notion, Obsidian, GitBook, Docusaurus of een statische sitegenerator
  • Het voor altijd bewaren --- Markdown-bestanden zijn platte tekst. Ze zijn over 50 jaar nog leesbaar

Aan de Slag

Installeer Save en probeer het nu op een Confluence-pagina. Het is gratis om mee te beginnen, en je ziet schone Markdown binnen seconden.

Ontsnappen aan Confluence hoeft niet pijnlijk te zijn. Save converteert elke pagina naar schone Markdown met één klik.