← Tilbage til blog

Sådan eksporterer du Confluence-sider til Markdown (2026-guide)

· Save Team
confluencemarkdowndocumentationenterprisemigration

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:

  1. Åbn enhver Confluence-side i Chrome
  2. Klik på Save-udvidelsesikonet
  3. 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:

  1. Gå til siden → menu → Eksporter til PDF/Word/HTML
  2. Vælg HTML-eksport
  3. 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:

  1. Gå til Space SettingsContent ToolsExport
  2. Vælg HTML-format
  3. Download ZIP-arkivet
  4. 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:

  1. Parse Atlassians lagringsformat
  2. Håndtere makroer, embeds og specielle elementer
  3. Konvertere til Markdown
  4. Gentage for hver side

Bedst til: Engineering-teams der bygger en migrationspipeline. Overkill til de fleste brugsscenarier.

Hvilken metode bør du bruge?

ScenarieBedste metode
Gem 1-50 sider hurtigtSave-udvidelsen --- ét klik per side
Arkiver et helt spaceSpace-eksport + Pandoc --- masse men rodet
Byg en migrationspipelineREST API --- programmatisk men kompleks
Hurtig sikkerhedskopi af nøgledokumenterSave-udvidelsen --- renest output
Fod dokumenter til en LLMSave-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.