Sådan eksporterer du Confluence-sider til Markdown (2026-guide)
Confluence vil ikke have dig til at gå. Atlassian gemmer dit indhold i et proprietært XML-format, tilbyder ingen Markdown-eksport og gør masseudtræk smertefuldt. Hvis du nogensinde har prøvet at få ren tekst ud af Confluence, kender du frustrationen.
Denne guide dækker alle metoder til at eksportere Confluence-sider til Markdown --- fra enkeltsider til hele spaces.
Hvorfor eksportere Confluence til Markdown?
Teams forlader Confluence af mange grunde:
- Migration til et nyt værktøj --- skifter til Notion, GitBook, Docusaurus eller en statisk site generator der forventer Markdown
- Arkivering af en vidensbase --- bevare teamdokumentation inden en Atlassian-licens udløber
- Bygge en AI-vidensbase --- fodre ren dokumentation til Claude, ChatGPT eller en intern LLM
- Sikkerhedskopiering af kritiske dokumenter --- have en portabel kopi der ikke afhænger af Atlassians servere
- Slippe fri af vendor lock-in --- eje dit indhold i et universelt format
Metode 1: Save (hurtigst for enkelsider)
Save er en Chrome-udvidelse der konverterer enhver Confluence-side til ren Markdown med ét klik.
Sådan fungerer det:
- Åbn enhver Confluence-side i Chrome
- Klik på Save-udvidelsesikonet
- En
.md-fil downloader øjeblikkeligt
Hvad du får:
- Fuld sidetekst med overskriftshierarki
- Tabeller formateret som Markdown-tabeller
- Kodeblokke med sprogtags
- Infopaneler konverteret til blokcitater
- Udvid/skjul-sektioner (fuldt udvidet)
- Rent metadata: sidetitel, spacenavn, sidst opdateret dato
- Interne og eksterne links bevaret
Hvad der fjernes:
- Atlassian-makroer og proprietær formatering
- Navigations-chrome, sidebars og menuer
- WYSIWYG-editorartefakter
- Inline-styles og CSS
Bedst til: Gemme enkelsider eller små batches. Hvis du har brug for 5-50 sider, er dette den hurtigste metode.
Eksempel på output
Fra en typisk Confluence runbook:
# 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);
\`\`\`
Metode 2: Confluences indbyggede eksport (HTML, derefter konverter)
Confluence kan eksportere sider som HTML. Du kan derefter konvertere HTML til Markdown med et værktøj som Pandoc.
Trin:
- Gå til siden → … menu → Eksporter til PDF/Word/HTML
- Vælg HTML-eksport
- Konverter med Pandoc:
pandoc input.html -o output.md
Problemer med denne tilgang:
- HTML-eksport inkluderer Atlassians CSS, makroer og inline-styles
- Tabeller brydes ofte under konvertering
- Kodeblokke mister sprogtags
- Billeder refererer til Confluence-URL’er der kan gå i stykker senere
- Indlejrede sider kræver eksport af hele spacet
Denne metode fungerer men producerer rodet output der kræver manuel oprydning.
Metode 3: Space-eksport + massekonvertering
For at eksportere et helt Confluence-space:
- Gå til Space Settings → Content Tools → Export
- Vælg HTML-format
- Download ZIP-arkivet
- Brug et script til at batch-konvertere HTML-filer til Markdown
Problemet: Confluence space-eksporter producerer dybt indlejret HTML med ødelagte relative links, duplikerede navigationselementer og Atlassian-specifik markup. At rydde dette op programmatisk er et weekendprojekt.
Metode 4: Confluence REST API
Til programmatisk adgang:
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
Dette giver dig det rå lagringsformat (XHTML-lignende). Du skal:
- Parse Atlassians lagringsformat
- Håndtere makroer, embeds og specielle elementer
- Konvertere til Markdown
- Gentage for hver side
Bedst til: Engineering-teams der bygger en migrationspipeline. Overkill til de fleste brugsscenarier.
Hvilken metode bør du bruge?
| Scenarie | Bedste metode |
|---|---|
| Gem 1-50 sider hurtigt | Save-udvidelsen --- ét klik per side |
| Arkiver et helt space | Space-eksport + Pandoc --- masse men rodet |
| Byg en migrationspipeline | REST API --- programmatisk men kompleks |
| Hurtig sikkerhedskopi af nøgledokumenter | Save-udvidelsen --- renest output |
| Fod dokumenter til en LLM | Save-udvidelsen --- Markdown er LLM-nativt |
For de fleste er Save svaret. Det producerer den reneste Markdown uden opsætning og håndterer automatisk Confluences proprietære formatering.
Gøre dit Confluence-indhold nyttigt
Når du har eksporteret dine sider til Markdown, kan du:
- Søge i alt med grep, VS Code eller Obsidian
- Fodre det til Claude eller ChatGPT for øjeblikkelige svar om din dokumentation
- Versionsstyring i Git --- spor ændringer til dine dokumenter som kode
- Importere til ethvert værktøj --- Notion, Obsidian, GitBook, Docusaurus eller en statisk site generator
- Beholde det for evigt --- Markdown-filer er ren tekst. De kan læses om 50 år
Kom i gang
Installer Save og prøv det på en Confluence-side nu. Det er gratis at starte, og du vil se ren Markdown inden for sekunder.
At slippe fri af Confluence behøver ikke at være smertefuldt. Save konverterer enhver side til ren Markdown med ét klik.