Tillbaka till bloggen

Hur Man Exporterar Confluence-sidor till Markdown (Guide 2026)

·
#confluence#markdown#documentation#enterprise#migration

Confluence vill inte att du lämnar. Atlassian lagrar ditt innehåll i ett eget XML-format, erbjuder ingen Markdown-export och gör bulkextrahering smärtsam. Om du någonsin försökt få ut ren text från Confluence vet du frustrationen.

Den här guiden täcker varje metod för att exportera Confluence-sidor till Markdown --- från enstaka sidor till hela spaces.

Varför Exportera Confluence till Markdown?

Team lämnar Confluence av många anledningar:

  • Migrera till ett nytt verktyg --- flytta till Notion, GitBook, Docusaurus eller en statisk webbplatsgenerator som förväntar sig Markdown
  • Arkivera en kunskapsbas --- bevara teamdokumentation innan en Atlassian-licens löper ut
  • Bygga en AI-kunskapsbas --- mata ren dokumentation till Claude, ChatGPT eller en intern LLM
  • Säkerhetskopiera kritiska dokument --- ha en portabel kopia som inte beror på Atlassians servrar
  • Fly leverantörsberoende --- äga ditt innehåll i ett universellt format

Metod 1: Save (Snabbast för Enskilda Sidor)

Save är ett Chrome-tillägg som konverterar vilken Confluence-sida som helst till ren Markdown med ett klick.

Hur det fungerar:

  1. Öppna en Confluence-sida i Chrome
  2. Klicka på Save-tilläggets ikon
  3. En .md-fil laddas ned omedelbart

Vad du får:

  • Full sidtext med rubrikhierarki
  • Tabeller formaterade som Markdown-tabeller
  • Kodblock med språktaggar
  • Informationspaneler konverterade till blockcitat
  • Expandera/dölj-sektioner (fullt expanderade)
  • Ren metadata: sidrubrik, space-namn, datum för senaste uppdatering
  • Interna och externa länkar bevarade

Vad som tas bort:

  • Atlassian-makron och egna formateringar
  • Navigeringskrom, sidofält och menyer
  • WYSIWYG-redigeringsartefakter
  • Inline-stilar och CSS

Bäst för: Spara enstaka sidor eller små batchar. Om du behöver 5-50 sidor är detta den snabbaste metoden.

Exempelutdata

Från ett typiskt Confluence runbook:

# Driftsättningsrunbook --- Produktions-API

**Space:** Engineering
**Senast uppdaterad:** 12 mars 2026

---

## Checklista Före Driftsättning

- [ ] Alla CI-kontroller godkända på `main`
- [ ] Databasmigrationer granskade och godkända
- [ ] Feature flags konfigurerade för gradvis utrullning
- [ ] Återställningsplan dokumenterad

## Driftsättningssteg

### 1. Skapa Release-gren

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

### 2. Kör Databasmigrationer

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

Metod 2: Confluences Inbyggda Export (HTML, Sedan Konvertera)

Confluence kan exportera sidor som HTML. Du kan sedan konvertera HTML till Markdown med ett verktyg som Pandoc.

Steg:

  1. Gå till sidan → -meny → Exportera till PDF/Word/HTML
  2. Välj HTML-export
  3. Konvertera med Pandoc: pandoc input.html -o output.md

Problem med denna metod:

  • HTML-export inkluderar Atlassians CSS, makron och inline-stilar
  • Tabeller bryts ofta under konverteringen
  • Kodblock förlorar språktaggar
  • Bilder refererar till Confluence-URL:er som kan brytas senare
  • Kapslade sidor kräver export av hela spacen

Den här metoden fungerar men producerar rörig utdata som kräver manuell rensning.

Metod 3: Space-export + Bulkkonvertering

För export av ett helt Confluence-space:

  1. Gå till Space-inställningarInnehållsverktygExportera
  2. Välj HTML-format
  3. Ladda ner ZIP-arkivet
  4. Använd ett skript för att batch-konvertera HTML-filer till Markdown

Problemet: Confluence space-exporter producerar djupt kapslad HTML med trasiga relativa länkar, duplicerade navigationselement och Atlassian-specifik markup. Att städa upp detta programmatiskt är ett helgprojekt.

Metod 4: Confluence REST API

För programmatisk åtkomst:

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

Detta ger dig det råa lagringsformatet (XHTML-liknande). Du behöver:

  1. Parsa Atlassians lagringsformat
  2. Hantera makron, inbäddningar och specialelement
  3. Konvertera till Markdown
  4. Upprepa för varje sida

Bäst för: Ingenjörsteam som bygger en migreringspipeline. Överdrivet för de flesta användningsfall.

Vilken Metod Bör Du Använda?

ScenarioBästa Metod
Spara 1-50 sidor snabbtSave-tillägg --- ett klick per sida
Arkivera ett helt spaceSpace-export + Pandoc --- bulk men rörigt
Bygga en migreringspipelineREST API --- programmatiskt men komplext
Snabb säkerhetskopiering av nyckeldokumentSave-tillägg --- renast utdata
Mata dokument till en LLMSave-tillägg --- Markdown är LLM-native

För de flesta är Save svaret. Det producerar den renaste Markdown utan setup, och hanterar Confluences egna formatering automatiskt.

Göra Ditt Confluence-innehåll Användbart

När du har exporterat dina sidor till Markdown kan du:

  • Söka i allt med grep, VS Code eller Obsidian
  • Mata Claude eller ChatGPT för omedelbara svar om din dokumentation
  • Versionskontrollera det i Git --- spåra ändringar i dina dokument som kod
  • Importera till vilket verktyg som helst --- Notion, Obsidian, GitBook, Docusaurus eller en statisk webbplatsgenerator
  • Behålla det för alltid --- Markdown-filer är ren text. De kommer vara läsbara om 50 år

Kom Igång

Installera Save och prova det på en Confluence-sida just nu. Det är gratis att börja, och du ser ren Markdown på sekunder.


Att fly Confluence behöver inte vara smärtsamt. Save konverterar vilken sida som helst till ren Markdown med ett klick.